home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / graphics / n-z / tsmorph / tsmorph.doc < prev    next >
Text File  |  1995-12-21  |  160KB  |  5,201 lines
  1. TSMorph.guide
  2.  
  3.  
  4. TSMorph 3.0 Contents
  5. ********************
  6.  
  7.  
  8.  
  9.   Overview                         Quick overview
  10.  
  11.   Installation                     Installation instructions
  12.   Requirements                     Software and Hardware required
  13.   Parameters                       Tool types and Shell parameters
  14.   Info Window                      The information window
  15.   Control Window                   The control window
  16.   Edit Windows                     The point edit windows
  17.   Edit Modes                       Point editing modes
  18.   Requesters                       Requesters which appear
  19.   Interface                        Changing the interface
  20.   File Format                      Internal file formats
  21.   ARexx                            ARexx interface to TSMorph-render and TSMorph
  22.   Algorithms                       Morphing algorithms
  23.   File Names                       File naming
  24.   Error Messages                   Error Messages
  25.   Bugs                             Known (and unknown) errors
  26.   Hardware&Software                Hardware and Software used in development
  27.   History                          Version History (since 2.0)
  28.  
  29.   Hints & Tips                     Some useful hints and tips
  30.  
  31.   Distribution                     Copyright and distribution requirements
  32.  
  33.   Index                            The index for this guide
  34.  
  35.  
  36.  
  37. TSMorph.guide/Overview
  38.  
  39.  
  40. Quick overview
  41. **************
  42.  
  43. For a quick tutorial see Tutorial/Tutorial.readme.
  44.  
  45. TSMorph is a set of morphing programs. It consists of two programs:
  46.  
  47.      TSMorph         Edit the Morph parameters
  48.      TSMorph-render  Generate the morphed images
  49.  
  50. TSMorph is used to create a parameter file  which is used by
  51. TSMorph-render to produce the morphed images. TSMorph-render works with
  52. 24 bit internally. Run times can be about 3 seconds per frame for a
  53. 150x150 image on a 28Mhz 68040 - See Benchmarks.
  54.  
  55. TSMorph-render can be used to morph one image to another in a set
  56. number of frames with a number of control points, just distort one
  57. image with control points. It can also be used to morph or warp a series
  58. of images (e.g. to morph between two animations). When TSMorph is run
  59. without parameters it will display an ASL file requester for a file
  60. created by TSMorph, it will then create the images, displaying a
  61. Progress Requester  on the default (or named) public screen allowing the
  62. process to be interrupted and/or stopped.
  63.  
  64. ARexx  scripts are run before and after each image is processed, and also
  65. before each image is loaded. These allow the changing of movement and
  66. colour to be controlled along with the ability to only generate some
  67. frames, and also pre and post image processing (e.g. to change to a
  68. non-24-bit format and build an animation).
  69.  
  70. TSMorph is used to generate the parameter file. When run it displays an
  71. Information Window  on a public screen. This allows the input of the file
  72. names to morph between, the number of frames, the start frame, the
  73. output file names, and the type of morph (single or dual images) to be
  74. changed.
  75.  
  76. It also allows the editing of control points on the images. The images
  77. (most image formats can be loaded - See OPENMODE ) are displayed on a
  78. public screen in resizeable, scrollable windows.
  79.  
  80. When the images are displayed control points can be edited in various
  81. modes. These modes allow the addition, deletion, linking and unlinking
  82. of the control points.
  83.  
  84. Context sensitive help is displayed using amigaguide (if available). The
  85. Help key can be pressed in the gadgets, over the gadgets, on menus or
  86. anytime a window is active.
  87.  
  88. TSMorph is ©1993/94 Topicsave Limited.
  89.  
  90. The author can be contacted by EMail as mark@topic.demon.co.uk or
  91. mpaddock@cix.compulink.co.uk.
  92.  
  93.  
  94.  
  95. TSMorph.guide/Installation
  96.  
  97.  
  98. Installation instructions
  99. *************************
  100.  
  101. If you wish to use Installer then TSMorph can be installed using the
  102. supplied script. If not then the following is a description of what the
  103. script does.
  104.  
  105.    * 1) Make a new drawer for the executables - default Work:TSMorph,
  106.  
  107.    * 2) Copy TSMorph, TSMorph-render, TSMorph.doc, TSMorph.guide,
  108.      TSMorph-prefs and the Rexx drawer and its contents and all their
  109.      icons to the drawer created in 1) above (if you have a 68020/030
  110.      with 68881/2 then copy the FPU version TSMorph-render.881 and
  111.      rename it as TSMorph-render instead of copying TSMorph-render, or
  112.      if you have a 68040 then copy the 040 version TSMorph-render.040
  113.      and rename it as TSMorph-render instead of copying TSMorph-render)
  114.  
  115.    * 3) If required copy the Brush and Cursor drawers and contents.
  116.  
  117.    * 4) Make new drawers ENVARC:TSMorph and ENV:TSMorph,
  118.  
  119.    * 5) Copy the default Icons to the directories created above.
  120.  
  121.    * 6) Amend your s:user-startup to assign TSMorph: to the drawer
  122.      created in step 1).
  123.  
  124.    * 7) Manually perform the assign in step 6).
  125.  
  126.    * 8) If you are running system version 3.0 (or greater) change the
  127.      default tool for TSMorph.guide to MultiView.
  128.  
  129.    * 9) If required copy the Tutorial directory to TSMorph:.
  130.  
  131.    * 10) If required copy the HTML directory to TSMorph:, also copy the
  132.      View_HTML icon and use an editor to make the file contain:
  133.  
  134.          CD HTML
  135.          Path:Mosaic file://localhost/TSMorph:html/TSMorph.html
  136.      
  137.              Where Path:Mosaic is the location of your version of Mosaic.
  138.  
  139. The following files are included in this distribution:
  140.  
  141.      COPYING                      GNU General Public License
  142.      TSMorph-render.881           The rendering program 68020/68881 version
  143.      TSMorph-render.881.info      Icon
  144.      TSMorph-render.040           The rendering program 68040 version
  145.      TSMorph-render.040.info      Icon
  146.      TSMorph                      The parameter set up program
  147.      TSMorph.info                 Icon
  148.      TSMorph-prefs                Preferences editor
  149.      TSMorph-prefs.info           Icon
  150.      TSMorph-render               The rendering program
  151.      TSMorph-render.info          Icon
  152.      TSMorph.doc                  Documentation in plain text format
  153.      TSMorph.doc.info             Icon
  154.      TSMorph.guide                Documentation in amigaguide format
  155.      TSMorph.guide.info           Icon
  156.      Install                      Installation script for Installer
  157.      Install.info                 Icon
  158.      Installer                    Commodore Installer
  159.      Read.Me                      Short read me file
  160.      Read.Me.info                 Icon
  161.      View_HTML.info               Icon
  162.      HTML/#?                      .html files
  163.      HTML/Images/#?               .html images
  164.      Env.info                     Icon
  165.      Env/TSMorph.info             Icon
  166.      Env/TSMorph/def_points.info  Default project Icon
  167.      Env/TSMorph/def_bw16.info    Default 16 colour grey Icon
  168.      Env/TSMorph/def_bw256.info   Default 256 colour grey Icon
  169.      Env/TSMorph/def_ham6.info    Default HAM 6 Icon
  170.      Env/TSMorph/def_ham8.info    Default HAM 8 Icon
  171.      Env/TSMorph/def_dctv3.info   Default DCTV 3 plane Icon
  172.      Env/TSMorph/def_dctv4.info   Default DCTV 4 plane Icon
  173.      Env/TSMorph/def_iff.info     Default OpalVision IFF Icon
  174.      Env/TSMorph/def_ilbm.info    Default 24 bit ILBM Icon
  175.      Env/TSMorph/def_jpg.info     Default OpalVision JPEG Icon
  176.      Env/TSMorph/def_ppm.info     Default PPM Icon
  177.      Env/TSMorph/def_prefs.info   Default prefs Icon
  178.      Rexx.info                    Icon
  179.      Rexx/FadeToBlack.TSM         Example prescript script
  180.      Rexx/FadeToBlack.TSM.info    Icon
  181.      Rexx/FadeToWhite.TSM         Example prescript script
  182.      Rexx/FadeToWhite.TSM.info    Icon
  183.      Rexx/Loadscript.TSM          Example loadscript script
  184.      Rexx/Loadscript.TSM.info     Icon
  185.      Rexx/PixelMorph.TSM          Example prescript script
  186.      Rexx/PixelMorph.TSM.info     Icon
  187.      Rexx/PixelWarp.TSM           Example prescript script
  188.      Rexx/PixelWarp.TSM.info      Icon
  189.      Rexx/PostAnim.TSM            Example postscript script
  190.      Rexx/PostAnim.TSM.info       Icon
  191.      Rexx/Postscript.TSM          Example postscript script
  192.      Rexx/Postscript.TSM.info     Icon
  193.      Rexx/PreAll.TSM              Example prescript script
  194.      Rexx/PreAll.TSM.info         Icon
  195.      Rexx/PreAnim.TSM             Example preview script
  196.      Rexx/PreAnim.TSM.info        Icon
  197.      Rexx/Prescript.TSM           Example prescript script
  198.      Rexx/Prescript.TSM.info      Icon
  199.      Rexx/Preview.TSM             Example preview script
  200.      Rexx/Preview.TSM.info        Icon
  201.      Rexx/ToHam.TSM               Example postscript script
  202.      Rexx/ToHam.TSM.info          Icon
  203.      Tutorial.info                Icon
  204.      Tutorial/cat.pic             Cat IFF image
  205.      Tutorial/girl.pic            Girl IFF image
  206.      Tutorial/Tutorial.readme     Tutorial instructions
  207.      Tutorial/Tutorial.readme.infoIcon
  208.      Brush.info                   Icon
  209.      Brush/1st                    Brush
  210.      Brush/1st.info               Icon
  211.      Brush/Add                    Brush
  212.      Brush/Add.info               Icon
  213.      Brush/Del                    Brush
  214.      Brush/Del.info               Icon
  215.      Brush/Goto                   Brush
  216.      Brush/Goto.info              Icon
  217.      Brush/Last                   Brush
  218.      Brush/Last.info              Icon
  219.      Brush/Link                   Brush
  220.      Brush/Link.info              Icon
  221.      Brush/Next                   Brush
  222.      Brush/Next.info              Icon
  223.      Brush/None                   Brush
  224.      Brush/None.info              Icon
  225.      Brush/one                    Brush
  226.      Brush/one.info               Icon
  227.      Brush/Prev                   Brush
  228.      Brush/Prev.info              Icon
  229.      Brush/Rel                    Brush
  230.      Brush/Rel.info               Icon
  231.      Brush/Two                    Brush
  232.      Brush/Two.info               Icon
  233.      Brush/Unlink                 Brush
  234.      Brush/Unlink.info            Icon
  235.      Cursor.info                  Icon
  236.      Cursor/XAdd                  Pointer
  237.      Cursor/XAdd.info             Icon
  238.      Cursor/XDel                  Pointer
  239.      Cursor/XDel.info             Icon
  240.      Cursor/XL1                   Pointer
  241.      Cursor/XL1.info              Icon
  242.      Cursor/XL2                   Pointer
  243.      Cursor/XL2.info              Icon
  244.      Cursor/XMov                  Pointer
  245.      Cursor/XMov.info             Icon
  246.      Cursor/XOne                  Pointer
  247.      Cursor/XOne.info             Icon
  248.      Cursor/XRel                  Pointer
  249.      Cursor/XRel.info             Icon
  250.      Cursor/XTwo                  Pointer
  251.      Cursor/XTwo.info             Icon
  252.      Cursor/XU1                   Pointer
  253.      Cursor/XU1.info              Icon
  254.      Cursor/XU2                   Pointer
  255.      Cursor/XU2.info              Icon
  256.  
  257.  
  258.  
  259. TSMorph.guide/Requirements
  260.  
  261.  
  262. Software and Hardware required
  263. ******************************
  264.  
  265. The following libraries (with minimum version) are required to run
  266. TSMorph:
  267.  
  268.      intuition.library        37
  269.      iffparse.library         37
  270.      graphics.library         37
  271.      layers.library           37
  272.      gadtools.library         37
  273.      asl.library              37
  274.      utility.library          37
  275.      diskfont.library         36
  276.      icon.library             37
  277.      rexxsyslib.library       0
  278.  
  279. The following will also be used if present:
  280.  
  281.      amigaguide.library       34
  282.      dctv.library             3
  283.      opal.library             0  Note: OpalVision board is not required
  284.      reqtools.library         38 reqtools is ©1991/1992 Nico François
  285.                                  This is required for Animated Warps/Morphs
  286.      nofrag.library           2  nofrag is © Copyright 1991 Jaba Development.
  287.      egs.library              0  EGS is © Copyright 1990/93 VIONA Development.
  288.      egsintui.library         0
  289.      egsgfx.library           0
  290.      egsrequest.library       0
  291.  
  292. TSMorph-render requires a large amount of chip memory (or
  293. opal.library). If you have 1Mb then 512x512 images can be morphed
  294. (though you may have to run workbench on a 2 colour 640x200 screen).
  295. 640x512 is probably impossible without 2Mb of chip memory.
  296.  
  297. The amount of chip memory required by TSMorph can be reduced to 1/5 by
  298. setting the ZOOM  parameter to OFF.
  299.  
  300.  
  301.  
  302. TSMorph.guide/Par
  303.  
  304.  
  305. Tool types and Shell parameters
  306. *******************************
  307.  
  308. Both TSMorph and TSMorph-render can be run from the Shell or the
  309. Workbench. Most parameters can be edited using the Settings  menu.
  310.  
  311. Note: TSMorph and TSMorph-render both require a stack size of more than
  312. 4096. 8192 should be OK. If the stack is not set large enough then the
  313. programs will probably just crash.
  314.  
  315. Parameters can be supplied, normally either on the Shell command line,
  316. as Icon Tool Types on the Project, TSMorph or TSMorph-render Icon, or
  317. in a settings file.
  318.  
  319. The format of settings files is a text file with lines in the format:
  320.  
  321.      Settingstype=settingsvalue
  322.  
  323. Blank lines or lines starting with a ; (semi-colon) are treated as
  324. comments. Any settings supplied on the Shell command line or as an Icon
  325. Tool Type override values specified in this file. Parameters on the
  326. Project Icon override parameters on the Tool Icon.
  327.  
  328. Note: All the Project Icon tool types are used if the project is run
  329. with a default tool or by double clicking a tool, some are not used if
  330. the project is selected using a file requester, if the Tool was run
  331. from the Shell then file requester selected project tool types are
  332. ignored. Also some settings can not be changed on open projects,
  333.  
  334. The Settings file name used is first file found from:
  335.  
  336.      1) The name supplied in the SETTINGS= parameter on the project.
  337.      2) The name supplied in the SETTINGS= parameter on the tool.
  338.      3) TSMorph.prefs
  339.         in the project directory for the workbench,
  340.         the current directory from the Shell.
  341.      4) TSMorph.prefs
  342.         in the directory TSMorph was loaded from.
  343.      5) ENV:TSMorph/TSMorph.prefs
  344.  
  345. Unless KEEPSETTINGS  is set to NO current settings are saved in
  346. ENV:TSMorph/TSMorph.prefs when TSMorph is quit. Settings can be saved
  347. and loaded from the Settings  menu.
  348.  
  349.  
  350.   TSMorph-prefs                      Preferences editor
  351.   TSMorph                            Parameters to TSMorph
  352.   TSMorph-render                     Parameters to TSMorph-render
  353.  
  354.  
  355.  
  356. TSMorph.guide/Par-TSMorph
  357.  
  358.  
  359. Parameters to TSMorph
  360. =====================
  361.  
  362. The following parameters can be supplied, normally either on the Shell
  363. command line, as Icon Tool Types on the Project or TSMorph Icon, or in
  364. a settings file:
  365.  
  366.  
  367.   CHANGEPALETTE                  Change screen palette to match image
  368.   CREATEICONS                    Create project Icons
  369.   CREATEICONSP                   Create prefs Icons
  370.   CUSTOMDEPTH                    Custom screen depth
  371.   CUSTOMMODE                     Custom screen mode
  372.   EGS                            Use EGS for image windows
  373.   FILES                          Specify file to open
  374.   HELP                           Display continuous help
  375.   KEEPSETTINGS                   Save settings on Quit
  376.   OPENMODE                       How to open images
  377.   PREVIEW                        ARexx script to preview image
  378.   PUBSCREEN                      Public screen to use
  379.   REQTOOLS                       Use Reqtools.library?
  380.   SETTINGS                       Settings file name
  381.   ZOOM                           Zoom image 2 times
  382.  
  383.  
  384.  
  385. TSMorph.guide/P-CHANGEPALETTE
  386.  
  387.  
  388. CHANGEPALETTE=YES/NO/OFF
  389. ------------------------
  390.  
  391. Sets the default value of the Change Palette? settings menu item -
  392. defaults to YES.
  393.  
  394. This item toggles if each images palette should be used to display the
  395. image when the window is active. Each image window can have its own
  396. palette. This option operates with the OPENMODE  parameter.
  397.  
  398. Since the ability to change screens colour palettes is not supported by
  399. CBM this menu option can be disabled by setting this parameter to OFF.
  400.  
  401.  
  402.  
  403. TSMorph.guide/P-CREATEICONS
  404.  
  405.  
  406. CREATEICONS=YES/NO
  407. ------------------
  408.  
  409. Sets the default value of the Create Icons? settings menu item -
  410. defaults to YES.
  411.  
  412. This item toggles if Icons are to be saved with parameter files. If it
  413. is selected then an Icon will be saved. The icon will come from
  414. ENV:TSMorph/def_points if this exists, secondly from
  415. ENV:SYS/def_points, otherwise the default project Icon is used.
  416.  
  417. This parameter is not changed by Requester loaded projects.
  418.  
  419.  
  420.  
  421. TSMorph.guide/P-CREATEICONSP
  422.  
  423.  
  424. CREATEICONSP=YES/NO
  425. -------------------
  426.  
  427. Sets the default value of the Create Prefs Icons? settings menu item -
  428. defaults to YES.
  429.  
  430. This item toggles if Icons are to be saved with Settings  files. If it is
  431. selected then an Icon will be saved. The icon will come from
  432. ENV:TSMorph/def_prefs if this exists, secondly from ENV:SYS/def_prefs,
  433. otherwise the default project Icon is used.
  434.  
  435.  
  436.  
  437. TSMorph.guide/P-CUSTOMDEPTH
  438.  
  439.  
  440. CUSTOMDEPTH=4
  441. -------------
  442.  
  443. This gives the depth of the custom screen to open if CUSTOMMODE  is
  444. specified.
  445.  
  446. It can be changed using the menu item (if reqtools.library is
  447. available), a requester is displayed allowing the input of the screen
  448. mode, but any change is ignored until TSMorph is reloaded.
  449.  
  450. The default value is 4.
  451.  
  452.  
  453.  
  454. TSMorph.guide/P-CUSTOMMODE
  455.  
  456.  
  457. CUSTOMMODE=screen_mode
  458. ----------------------
  459.  
  460. This gives the mode of the custom screen to open.
  461.  
  462. The mode is as show in the Screen Mode requester - case is ignored
  463. (e.g. "PAL:Low Res"). This parameter is not changed by Requester loaded
  464. projects.
  465.  
  466. The name of the screen must be given by the PUBSCREEN  parameter. The
  467. depth is given by the CUSTOMDEPTH  parameter. The screen will mostly
  468. clone the Workbench, but other colours will be set up as a grey scale.
  469.  
  470. It can be changed using the menu item (if reqtools.library is
  471. available), a requester is displayed allowing the input of the screen
  472. mode, but any change is ignored until TSMorph is reloaded.
  473.  
  474. The default value is nothing which means do not open a custom screen.
  475.  
  476.  
  477.  
  478. TSMorph.guide/P-EGS
  479.  
  480.  
  481. EGS=YES/NO
  482. ----------
  483.  
  484. This controls the use of EGS when displaying the edit  windows. See
  485. requirements  for library requirements. If set to yes then the edit 
  486. windows and relevent error  requesters are displayed on the default EGS
  487. screen.
  488.  
  489. ZOOM  is always set to OFF when using EGS. OPENMODE  may also be ignored
  490. in some circumstances.
  491.  
  492. This parameter is not available as a menu option, is not saved in
  493. settings files and can not be specified on a project Icon.
  494.  
  495. Default values is NO.
  496.  
  497.  
  498.  
  499. TSMorph.guide/P-FILES
  500.  
  501.  
  502. FILES=filename
  503. --------------
  504.  
  505. This is only relevant to the Shell, only one name can be supplied -
  506. default is to open a new unnamed project.
  507.  
  508.  
  509.  
  510. TSMorph.guide/P-HELP
  511.  
  512.  
  513. HELP=YES/NO
  514. -----------
  515.  
  516. Sets the default value of the Continuous Help? settings menu item -
  517. defaults to NO.
  518.  
  519. This option has more effect when running release 3.0 or later. When set
  520. to YES help is continuously displayed using amigaguide (if available).
  521.  
  522.  
  523.  
  524. TSMorph.guide/P-KEEPSETTINGS
  525.  
  526.  
  527. KEEPSETTINGS=YES/NO
  528. -------------------
  529.  
  530. Sets the default value of the Keep Settings? settings menu item -
  531. defaults to YES.
  532.  
  533. By default current settings are saved in ENV:TSMorph/TSMorph.prefs when
  534. TSMorph is quit. This parameter and menu item enable this behaviour to
  535. be turned off.
  536.  
  537.  
  538.  
  539. TSMorph.guide/P-OPENMODE
  540.  
  541.  
  542. OPENMODE=ALWAYS/IFILBM/IFCOLOURS/REMAP/OPAL
  543. -------------------------------------------
  544.  
  545. This parameter and menu item specify how images should be loaded for
  546. displaying by TSMorph.
  547.  
  548.    *     ALWAYS    - Only try and load normal ILBM images. Fail if not.
  549.      The CHANGEPALETTE  parameter has an affect on the image display.
  550.  
  551.    *     IFILBM    - First try to load as an ILBM image, load and remap
  552.      the image if the image is not an ILBM or has 24 planes.
  553.  
  554.    *     IFCOLOURS - As IFILBM but remap if the number of planes in the
  555.      image exceed the number of the screen.
  556.  
  557.    *     REMAP     - Loads most ILBM (including 24 bit, EHB, HAM6, HAM8
  558.      and DCTV (with dctv.library [REMAP needs to be specified to
  559.      correctly display DCTV images]), JPEG, TARGA, PPM and GIF. For
  560.      JPEG if CHANGEPALETTE=YES or NO  and the screen (see PUBSCREEN ) has
  561.      more than 2 bit planes then the image is remapped to a dynamic
  562.      type palette. Otherwise the image is remapped to the screen
  563.      palette. If this fails then opal.library will be used (if
  564.      present). This may be required for some JPEGs.
  565.  
  566.    *     OPAL      - Always use opal.library to load the image. This is
  567.      probably only useful to load images in Opal FAST IFF format.  The
  568.      images are remapped to the current palette.
  569.  
  570. When loading and remapping complex images a requester is displayed with
  571. a title of Loading Image, a text gadget giving progress messages, a
  572. Pass gadget, and a third progress gadget. There is no way of
  573. interrupting the load process.
  574.  
  575. For slow machines it is suggested that you convert the images to ILBMs
  576. and specify ALWAYS.
  577.  
  578.  
  579.  
  580. TSMorph.guide/P-PREVIEW
  581.  
  582.  
  583. PREVIEW=scriptname
  584. ------------------
  585.  
  586. This specifies the name of an ARexx  script to run to preview the
  587. rendered image.
  588.  
  589. The default script is Rexx/Preview.
  590.  
  591. The version supplied renders the image as a 16 colour grey scale with a
  592. resolution of about 128/64 and displays it.
  593.  
  594. It can be changed using the menu item (if reqtools.library is
  595. available), a requester is displayed allowing the input of the value.
  596.  
  597.  
  598.  
  599. TSMorph.guide/P-PUBSCREEN
  600.  
  601.  
  602. PUBSCREEN=pubscreenname
  603. -----------------------
  604.  
  605. This gives the name of the Public Screen on which to open all TSMorph
  606. windows - default is the default public screen.
  607.  
  608. This parameter is not changed by Requester loaded projects.
  609.  
  610. It can be changed using the menu item (if reqtools.library is
  611. available), a requester is displayed allowing the input of the screen
  612. name, but any change is ignored until TSMorph is reloaded.
  613.  
  614. If CUSTOMMODE  is supplied as well then a public screen of this name is
  615. opened.
  616.  
  617.  
  618.  
  619. TSMorph.guide/P-REQTOOLS
  620.  
  621.  
  622. REQTOOLS=YES/NO/ALL
  623. -------------------
  624.  
  625. This controls the use of reqtools.library. If set to NO then reqtools
  626. will not be used (except in very unusual circumstances). It will still
  627. however be opened and closed. If set to YES then reqtools will be used
  628. for various requesters. If set to ALL then it will be used for the File
  629. Requesters as well.
  630.  
  631. This parameter is not available as a menu option, is not saved in
  632. settings files and can not be specified on a project Icon.
  633.  
  634. Default values is YES.
  635.  
  636.  
  637.  
  638. TSMorph.guide/P-SETTINGS
  639.  
  640.  
  641. SETTINGS=filename
  642. -----------------
  643.  
  644. This can only be supplied on the Shell command line, or an Icon Tool
  645. Type. It specifies the name of a file for more parameters. See
  646. parameters.
  647.  
  648. This parameter is not changed by Requester loaded projects.
  649.  
  650.  
  651.  
  652. TSMorph.guide/P-ZOOM
  653.  
  654.  
  655. ZOOM=YES/NO/OFF
  656. ---------------
  657.  
  658. Sets the default value of the Zoom? settings menu item. If set to YES
  659. then images will be initially displayed 2x normal size, if set to NO
  660. then images will be initially displayed normal size, setting to OFF
  661. disables the Zoom? option, this reduces chip memory usage to 1/5 -
  662. defaults to NO.
  663.  
  664.  
  665.  
  666. TSMorph.guide/Par-TSMorph-render
  667.  
  668.  
  669. Parameters to TSMorph-render
  670. ============================
  671.  
  672. The following parameters can be supplied, normally either on the Shell
  673. command line, as Icon Tool Types on the Project or TSMorph-render Icon,
  674. or in a settings file:
  675.  
  676.  
  677.   ANTIALIAS                    Anti-Alias the output files
  678.   CREATEICONSR                 Create image Icons
  679.   DEPTH                        Depth for search algorithm
  680.   DX                           Horizontal Pixelation
  681.   DY                           Vertical Pixelation
  682.   EGS                          Render to EGS window as well
  683.   FILES                        Specify file to open
  684.   INTEGER                      Integer render calculation
  685.   LOADSCRIPT                   Script before each image loaded
  686.   MODE                         Mode for rendering algorithm
  687.   POSTSCRIPT                   Script after rendering frame
  688.   PRESCRIPT                    Script before rendering frame
  689.   PUBSCREENR                   Public screen to use
  690.   QUALITY                      JPEG Quality
  691.   REQTOOLS                     Use Reqtools.library?
  692.   SAVEFORMAT                   Format to save images
  693.   SETTINGS                     Settings file name
  694.   TOOLPRI                      Priority of TSMorph-render
  695.  
  696.  
  697.  
  698. TSMorph.guide/P-ANTIALIAS
  699.  
  700.  
  701. ANTIALIAS=NO/YES
  702. ----------------
  703.  
  704. This parameter and menu item select if the output files should be
  705. Anti-Aliased. Setting to YES can improve the quality of the images but
  706. will slow down the rendering process.
  707.  
  708. This parameter is ignored if INTEGER  is set to YES.
  709.  
  710. Default value is NO.
  711.  
  712.  
  713.  
  714. TSMorph.guide/P-CREATEICONSR
  715.  
  716.  
  717. CREATEICONSR=NO/YES
  718. -------------------
  719.  
  720. This parameter and menu item selects if Icons are to be saved with
  721. image files. If it is YES then an Icon will be saved. The icon depends
  722. on the save format.
  723.  
  724.      ENV:TSMorph/def_bw16  - 16 colour grey scale images
  725.      ENV:TSMorph/def_bw256 - 256 colour grey scale images
  726.      ENV:TSMorph/def_ham6  - HAM 6 images
  727.      ENV:TSMorph/def_ham8  - HAM 8 images
  728.      ENV:TSMorph/def_dctv3 - DCTV 3 plane images using dctv.library
  729.      ENV:TSMorph/def_dctv4 - DCTV 4 plane images using dctv.library
  730.      ENV:TSMorph/def_iff   - 24 bit ILBM saved using opal.library
  731.      ENV:TSMorph/def_ilbm  - 24 bit ILBM saved without opal.library
  732.      ENV:TSMorph/def_jpg   - JPEG files saved using opal.library
  733.      ENV:TSMorph/def_ppm   - PPM files
  734.  
  735. If the file does not exist then ENV:SYS/def_ilbm (etc.) is tried, if
  736. this does not exist then the default project Icon is used.
  737.  
  738. Default value is NO.
  739.  
  740.  
  741.  
  742. TSMorph.guide/P-DEPTH
  743.  
  744.  
  745. DEPTH=number
  746. ------------
  747.  
  748. This parameter indicates how deep the Morphing algorithm  should search
  749. to find the points to use for morphing. The maximum value is 20 (higher
  750. values are accepted but will be taken as 20).
  751.  
  752. Default value is 2.
  753.  
  754. It can be changed using the menu item (if reqtools.library is
  755. available), a requester is displayed allowing the input of the value.
  756.  
  757.  
  758.  
  759. TSMorph.guide/P-DX
  760.  
  761.  
  762. DX=number
  763. ---------
  764.  
  765. This parameter can be used to speed up the rendering process. The
  766. default value is 0.
  767.  
  768. If set to a number then only some Horizontal pixels will be generated.
  769. e.g. if set to 3 then only every 4th pixel will be generated. The
  770. others will be copied from the previous pixel. This can be overridden
  771. by using ARexx. Also see DY.
  772.  
  773. It can be changed using the menu item (if reqtools.library is
  774. available), a requester is displayed allowing the input of the value.
  775.  
  776.  
  777.  
  778. TSMorph.guide/P-DY
  779.  
  780.  
  781. DY=number
  782. ---------
  783.  
  784. This parameter can be used to speed up the rendering process. The
  785. default value is 0.
  786.  
  787. If set to a number then only some Vertical pixels will be generated.
  788. e.g. if set to 1 then only every other line will be generated. The
  789. others will be copied from the previous line. This can be overridden by
  790. using ARexx. Also see DX.
  791.  
  792. It can be changed using the menu item (if reqtools.library is
  793. available), a requester is displayed allowing the input of the value.
  794.  
  795.  
  796.  
  797. TSMorph.guide/P-EGS-R
  798.  
  799.  
  800. EGS=YES/NO
  801. ----------
  802.  
  803. By default TSMorph-render does not show its output when rendering. If
  804. this parameter is set to YES then output will be displayed in an EGS
  805. window on the default EGS screen a line at a time. See requirements  for
  806. library requirements.
  807.  
  808. This parameter is not available as a menu option, is not saved in
  809. settings files and can not be specified on a project Icon.
  810.  
  811. Default values is NO.
  812.  
  813.  
  814.  
  815. TSMorph.guide/P-FILES-R
  816.  
  817.  
  818. FILES=filename
  819. --------------
  820.  
  821. This is only relevant to the Shell, only one name can be supplied -
  822. default is to show an ASL file requester for the file to run.
  823.  
  824.  
  825.  
  826. TSMorph.guide/P-INTEGER
  827.  
  828.  
  829. INTEGER=NO/YES
  830. --------------
  831.  
  832. This parameter and menu item select if the render process should use
  833. integer or floating point arithmetic. The process will be faster if
  834. integer arithmetic is used (especially on machines without an FPU).
  835. However the output quality will not be so good.
  836.  
  837. If this parameter is set to YES then the ANTIALIAS  parameter is ignored.
  838.  
  839. Default value is NO.
  840.  
  841.  
  842.  
  843. TSMorph.guide/P-LOADSCRIPT
  844.  
  845.  
  846. LOADSCRIPT=Scriptname/OFF
  847. -------------------------
  848.  
  849. This specifies the name of an ARexx  script to run before each image 24
  850. bit image is loaded. This can be used to e.g. hold the images on disc
  851. in JPEG format to save space and convert each image back to 24 bit ILBM
  852. when required. Note however that TSMorph-render now has the ability to
  853. load a large variety of image formats (All ILBM including HAM6, HAM8,
  854. EHB, and DCTV with dctv.library, JPEG, TARGA, PPM, and GIF).
  855.  
  856. The default script is Rexx/Loadscript.
  857.  
  858. The version supplied does nothing.
  859.  
  860. Set to OFF to run no script.
  861.  
  862. It can be changed using the menu item (if reqtools.library is
  863. available), a requester is displayed allowing the input of the value.
  864.  
  865.  
  866.  
  867. TSMorph.guide/P-MODE
  868.  
  869.  
  870. MODE=0-31
  871. ---------
  872.  
  873. This parameter and menu item indicate how the Morphing algorithm  should
  874. search to find the points to use for morphing.
  875.  
  876. The values are additive:
  877.         1 : Leaves un-triangled point stationary
  878.         2 : Searches all the closest points
  879.         4 : Uses a squaring algorithm to find close points
  880.         8 : Uses a Delaunay algorithm to find triangles
  881.         16: Precalculate close points
  882.  
  883. Default value is 0.
  884.  
  885.  
  886.  
  887. TSMorph.guide/P-POSTSCRIPT
  888.  
  889.  
  890. POSTSCRIPT=Scriptname/OFF
  891. -------------------------
  892.  
  893. This specifies the name of an ARexx  script to run after each image is
  894. rendered. This can be used to build an animation or change the image
  895. format from 24 bit.
  896.  
  897. The default script is Rexx/Postscript.
  898.  
  899. The version supplied does nothing.
  900.  
  901. Set to OFF to run no script.
  902.  
  903. It can be changed using the menu item (if reqtools.library is
  904. available), a requester is displayed allowing the input of the value.
  905.  
  906.  
  907.  
  908. TSMorph.guide/P-PRESCRIPT
  909.  
  910.  
  911. PRESCRIPT=Scriptname/OFF
  912. ------------------------
  913.  
  914. This specifies the name of an ARexx  script to run before each image is
  915. rendered. This can be used to produce only some of the frames and
  916. control the movement and colour of the images.
  917.  
  918. The default script is Rexx/Prescript.
  919.  
  920. The version supplied does nothing.
  921.  
  922. Set to OFF to run no script.
  923.  
  924. It can be changed using the menu item (if reqtools.library is
  925. available), a requester is displayed allowing the input of the value.
  926.  
  927.  
  928.  
  929. TSMorph.guide/P-PUBSCREENR
  930.  
  931.  
  932. PUBSCREENR=pubscreenname
  933. ------------------------
  934.  
  935. This gives the name of the Public Screen on which to open
  936. TSMorph-render windows - default is the default public screen.
  937.  
  938. It can be changed using the menu item (if reqtools.library is
  939. available), a requester is displayed allowing the input of the screen
  940. name.
  941.  
  942.  
  943.  
  944. TSMorph.guide/P-QUALITY
  945.  
  946.  
  947. QUALITY=number
  948. --------------
  949.  
  950. This specifies the quality of output files. This option only applies if
  951. opal.library is available and SAVEFORMAT  is JPEG or JPEGT. Possible
  952. values are 0 to 100.
  953.  
  954. Default value is 75.
  955.  
  956. It can be changed using the menu item (if reqtools.library is
  957. available), a requester is displayed allowing the input of the value.
  958.  
  959.  
  960.  
  961. TSMorph.guide/P-REQTOOLS-R
  962.  
  963.  
  964. REQTOOLS=YES/NO/ALL
  965. -------------------
  966.  
  967. This controls the use of reqtools.library. If set to NO then reqtools
  968. will not be used (except in very unusual circumstances). It will still
  969. however be opened and closed. If set to YES then reqtools will be used
  970. for various requesters. If set to ALL then it will be used for the File
  971. Requesters as well.
  972.  
  973. This parameter is not available as a menu option, is not saved in
  974. settings files and can not be specified on a project Icon.
  975.  
  976. Default values is YES.
  977.  
  978.  
  979.  
  980. TSMorph.guide/P-SAVEFORMAT
  981.  
  982.  
  983. SAVEFORMAT=ILBM24/OPAL24/OPAL24T/OPAL24F/OPAL24FT/JPEG/JPEGT/PPM/BW16/BW256/HAM6/HAM8/DCTV3/DCTV4
  984. -------------------------------------------------------------------------------------------------
  985.  
  986. This parameter and menu item specify the format TSMorph-render should
  987. use to save the output images. OPAL and JPEG formats are only available
  988. if opal.library is available. DCTV3 and DCTV4 formats are only
  989. available if dctv.library is available.
  990.  
  991.      ILBM24   - IFF 24 bit ILBM with no CAMG chunk
  992.      OPAL24   - IFF 24 bit ILBM saved using opal.library
  993.      OPAL24T  - as OPAL24 with a Thumbnail
  994.      OPAL24F  - as OPAL24 in Fast Format
  995.      OPAL24TF - as OPAL24F with a Thumbnail
  996.      JPEG     - JPEG format using opal.library
  997.      JPEGT    - as JPEG with a Thumbnail
  998.      PPM      - PPM format
  999.      BW16     - ILBM 16 colour grey scale
  1000.      BW256    - ILBM 256 colour grey scale
  1001.      HAM6     - ILBM 6 plane HAM
  1002.      HAM8     - ILBM 8 plane HAM
  1003.      DCTV3    - ILBM 3 plane DCTV using dctv.library
  1004.      DCTV4    - ILBM 4 plane DCTV using dctv.library
  1005.  
  1006. The quality of JPEG images can be set using the QUALITY  parameter.
  1007.  
  1008. PPM format is basically uncompressed 24 bit. The files are therefore
  1009. very large and it is suggested that a compressing file handler (such as
  1010. XFH or EPU) is used. This format is provided mainly to allow the easy
  1011. production of MPEG movies.
  1012.  
  1013. The save format also controls which Icon  is saved with the image.
  1014.  
  1015.  
  1016.  
  1017. TSMorph.guide/P-SETTINGS-R
  1018.  
  1019.  
  1020. SETTINGS=filename
  1021. -----------------
  1022.  
  1023. This can only be supplied on the Shell command line, or an Icon Tool
  1024. Type.
  1025.  
  1026. This specifies the name of a file to contain settings.  See parameters.
  1027.  
  1028.  
  1029.  
  1030. TSMorph.guide/P-TOOLPRI
  1031.  
  1032.  
  1033. TOOLPRI=number
  1034. --------------
  1035.  
  1036. This can only be supplied as a Tool Icon tool type. It sets the
  1037. priority of the rendering process.
  1038.  
  1039. Setting to -1 is a good idea if you wish to run the program in the
  1040. background. The default value is 0. Setting to positive values is
  1041. generally not a good idea.
  1042.  
  1043.  
  1044.  
  1045. TSMorph.guide/Info
  1046.  
  1047.  
  1048. The Information Window
  1049. **********************
  1050.  
  1051. This window is always displayed when TSMorph is running. It displays
  1052. information about the current project. The window title is TSMorph, the
  1053. screen title will be displayed as the project name if the project has a
  1054. name. It is used to set up all the information required by
  1055. TSMorph-render.
  1056.  
  1057.  
  1058.   Gadgets         Gadgets displayed in the Info Window
  1059.   Menus           Menus available in the Info Window
  1060.   Keyboard        Keyboard controls in the Info Window
  1061.  
  1062.  
  1063.  
  1064. TSMorph.guide/I-gad
  1065.  
  1066.  
  1067. Gadgets in Info Window
  1068. ======================
  1069.  
  1070.  
  1071.      -----------------------------
  1072.      |. |TSMorph           |  |  |
  1073.      |---------------------------|
  1074.      |        Help Text          |
  1075.      | File One .............  X |
  1076.      | File Two .............  X |
  1077.      |24 File 1 .............  X |
  1078.      |24 File 2 .............  X |
  1079.      |    Width ...   Height ... |
  1080.      | Single  Frames..  Start . |
  1081.      |     Name ............   X |
  1082.      |      Edit Points...       |
  1083.      -----------------------------
  1084.  
  1085.  
  1086.   Help Text                           Displays help messages (release 3.0+)
  1087.   File One                            The first image file for point editing
  1088.   Get file                            Get file gadget for above
  1089.   File Two                            The second image file for point editing
  1090.   Get File                            Get file gadget for above
  1091.   24 File 1                           The first 24 bit image file to morph
  1092.   Get File                            Get file gadget for above
  1093.   24 File 2                           The second 24 bit image file to morph
  1094.   Get File                            Get file gadget for above
  1095.   Width                               Read only gadget showing width
  1096.   Height                              Read only gadget showing Height
  1097.   Single                              Cycle morph mode gadget
  1098.   Frames                              Number of frames to generate
  1099.   Start                               Frame number to start at
  1100.   Name                                File name of animation frames
  1101.   Get File                            Get file gadget for above
  1102.   Edit Points...                      Display images to edit points
  1103.  
  1104.   Close gadget                        Quit program
  1105.   Zoom gadget                         Standard zoom window
  1106.   Depth gadget                        Standard depth gadget
  1107.  
  1108.  
  1109.  
  1110. TSMorph.guide/I-gad-Help
  1111.  
  1112.  
  1113. Help Text gadget
  1114. ----------------
  1115.  
  1116. This gadget displays short help messages.
  1117.  
  1118. From release 3.0 and up it displays more information. See also
  1119. Continuous Help.
  1120.  
  1121.  
  1122.  
  1123. TSMorph.guide/I-gad-File_One
  1124.  
  1125.  
  1126. File One gadget
  1127. ---------------
  1128.  
  1129. This gadget allows the editing of the file name of the first image to
  1130. be used when editing points. This gadget is disabled if the
  1131. Edit Windows  are currently open. The file name can be either edited in
  1132. the string gadget or by using the Get File  to display an ASL file
  1133. requester.
  1134.  
  1135. This image should be a Workbench displayable version of the
  1136. first 24 bit file. (See OPENMODE  for what images can be loaded.) It is
  1137. displayed in the first Edit Window  when editing points.
  1138.  
  1139. o can be used to activate this gadget - See Keyboard.
  1140.  
  1141. See File naming  for how to specify the file name.
  1142.  
  1143.  
  1144.  
  1145. TSMorph.guide/I-gad-Get_File_One
  1146.  
  1147.  
  1148. Get File One gadget
  1149. -------------------
  1150.  
  1151. This gadget displays an ASL file requester to select the file to appear
  1152. in the File One  gadget.
  1153.  
  1154. o with shift is the same as using this gadget - See Keyboard.
  1155.  
  1156.  
  1157.  
  1158. TSMorph.guide/I-gad-File_Two
  1159.  
  1160.  
  1161. File Two gadget
  1162. ---------------
  1163.  
  1164. This gadget is the same as the File One  gadget for the second
  1165. displayable image. This image should be the same size as the first.
  1166.  
  1167. t can be used to activate this gadget - See Keyboard.
  1168.  
  1169. See File naming  for how to specify the file name.
  1170.  
  1171.  
  1172.  
  1173. TSMorph.guide/I-gad-Get_File_Two
  1174.  
  1175.  
  1176. Get File Two gadget
  1177. -------------------
  1178.  
  1179. This gadget displays an ASL file requester to select the file to appear
  1180. in the File Two  gadget.
  1181.  
  1182. t with shift is the same as using this gadget - See Keyboard.
  1183.  
  1184.  
  1185.  
  1186. TSMorph.guide/I-gad-24_File_1
  1187.  
  1188.  
  1189. 24 File 1 gadget
  1190. ----------------
  1191.  
  1192. This gadget allows the editing of the file name of the first image to
  1193. be used when morphing. The file name can be either edited in the string
  1194. gadget or by using the Get File  to display an ASL file requester.
  1195.  
  1196. This image should be a 24 bit version of the first displayable file.
  1197. Also see the LOADSCRIPT  parameter. Note: TSMorph now has the ability to
  1198. load a large variety of images as 24 bit files. If this gadget is left
  1199. blank then the name from the first displayable file  is used.
  1200.  
  1201. 1 can be used to activate this gadget - See Keyboard.
  1202.  
  1203. See File naming  for how to specify the file name.
  1204.  
  1205.  
  1206.  
  1207. TSMorph.guide/I-gad-Get_24_File_1
  1208.  
  1209.  
  1210. Get 24 File 1 gadget
  1211. --------------------
  1212.  
  1213. This gadget displays an ASL file requester to select the file to appear
  1214. in the 24 File 1  gadget.
  1215.  
  1216. 1 with shift is the same as using this gadget - See Keyboard.
  1217.  
  1218.  
  1219.  
  1220. TSMorph.guide/I-gad-24_File_2
  1221.  
  1222.  
  1223. 24 File 2 gadget
  1224. ----------------
  1225.  
  1226. This gadget allows the editing of the file name of the last image to be
  1227. used when morphing. The file name can be either edited in the string
  1228. gadget or by using the Get File  to display an ASL file requester.
  1229.  
  1230. This image should be a 24 bit version of the second displayable file.
  1231. Also see the LOADSCRIPT  parameter. Note: TSMorph now has the ability to
  1232. load a large variety of images as 24 bit files. If this gadget is left
  1233. blank then the name from the second displayable file  is used.
  1234.  
  1235. If Single Image  mode is selected then this is ignored.
  1236.  
  1237. 2 can be used to activate this gadget - See Keyboard.
  1238.  
  1239. See File naming  for how to specify the file name.
  1240.  
  1241.  
  1242.  
  1243. TSMorph.guide/I-gad-Get_24_File_2
  1244.  
  1245.  
  1246. Get 24 File 2 gadget
  1247. --------------------
  1248.  
  1249. This gadget displays an ASL file requester to select the file to appear
  1250. in the 24 File 2  gadget.
  1251.  
  1252. 2 with shift is the same as using this gadget - See Keyboard.
  1253.  
  1254.  
  1255.  
  1256. TSMorph.guide/I-gad-Width
  1257.  
  1258.  
  1259. Width gadget
  1260. ------------
  1261.  
  1262. This gadget displays the width of the images being edited. If images
  1263. have not been selected then it should display the maximum width of the
  1264. current points.
  1265.  
  1266.  
  1267.  
  1268. TSMorph.guide/I-gad-Height
  1269.  
  1270.  
  1271. Height gadget
  1272. -------------
  1273.  
  1274. This gadget displays the height of the images being edited. If images
  1275. have not been selected then it should display the maximum height of the
  1276. current points.
  1277.  
  1278.  
  1279.  
  1280. TSMorph.guide/I-gad-Single
  1281.  
  1282.  
  1283. Single image gadget
  1284. -------------------
  1285.  
  1286. This gadget cycles between Morphs, Warps, Animated Morphs and Animated
  1287. Warps.
  1288.  
  1289. In Warp mode one image is distorted based on the control points.
  1290.  
  1291. In Morph mode one image is distorted/recoloured into a second image
  1292. based on control points.
  1293.  
  1294. In animated Warps and Morphs the input images can change on each output
  1295. frame.
  1296.  
  1297. r and R can be used to cycle this gadget forward and backward - See
  1298. Keyboard.
  1299.  
  1300. Note: Animated Warps/Morphs are only available if Reqtools is available.
  1301.  
  1302.  
  1303.  
  1304. TSMorph.guide/I-gad-Frames
  1305.  
  1306.  
  1307. Number of Frames gadget
  1308. -----------------------
  1309.  
  1310. This gadget can be used to specify the number of frames to generate.
  1311.  
  1312. In Single  mode the total number of frames will be this number plus the
  1313. first image.
  1314.  
  1315. In dual mode the total number of frames is the first image, this number
  1316. and the last image.
  1317.  
  1318. f can be used to activate this gadget - See Keyboard.
  1319.  
  1320. This gadget is disabled if Images are displayed and an animated
  1321. Morph/Warp is being edited.
  1322.  
  1323.  
  1324.  
  1325. TSMorph.guide/I-gad-Start
  1326.  
  1327.  
  1328. Start Frame gadget
  1329. ------------------
  1330.  
  1331. This gadget can be used to specify the number to use in the Name  of the
  1332. first generated file. This number is then incremented by 1 for each
  1333. subsequent frame.
  1334.  
  1335. a can be used to activate this gadget - See Keyboard.
  1336.  
  1337. This gadget is disabled if Images are displayed and an animated
  1338. Morph/Warp is being edited.
  1339.  
  1340.  
  1341.  
  1342. TSMorph.guide/I-gad-Name
  1343.  
  1344.  
  1345. Anim file Name gadget
  1346. ---------------------
  1347.  
  1348. This gadget is used to name the files produced by TSMorph-render.
  1349.  
  1350. The file name can be either edited in the string gadget or by using the
  1351. Get File  to display an ASL file requester.
  1352.  
  1353. The file name should contain the characters %ld. These characters will
  1354. be replaced by the frame number, starting from that specified in the
  1355. Start  gadget.
  1356.  
  1357. n can be used to activate this gadget - See Keyboard.
  1358.  
  1359. See File naming  for further information on how to specify the file name.
  1360.  
  1361.  
  1362.  
  1363. TSMorph.guide/I-gad-Get_Name
  1364.  
  1365.  
  1366. Get Anim file Name gadget
  1367. -------------------------
  1368.  
  1369. This gadget displays an ASL file requester to select the file to appear
  1370. in the Name  gadget.
  1371.  
  1372. n with shift is the same as using this gadget - See Keyboard.
  1373.  
  1374.  
  1375.  
  1376. TSMorph.guide/I-gad-Edit_Points
  1377.  
  1378.  
  1379. Edit Points... gadget
  1380. ---------------------
  1381.  
  1382. This button gadget has the same effect as the Edit Points  menu option.
  1383. It opens the Control Window  and Edit Windows  to allow editing of the
  1384. control points. If these windows are already open then the Control
  1385. Window is activated.
  1386.  
  1387. p is the same as using this gadget - See Keyboard.
  1388.  
  1389.  
  1390.  
  1391. TSMorph.guide/I-gad-Close
  1392.  
  1393.  
  1394. Close gadget
  1395. ------------
  1396.  
  1397. This is a standard close gadget. Clicking quits the program.
  1398.  
  1399. If the current project has been changed but not saved then the
  1400. Unsaved Project requester  is displayed.
  1401.  
  1402.  
  1403.  
  1404. TSMorph.guide/I-gad-Zoom
  1405.  
  1406.  
  1407. Zoom gadget
  1408. -----------
  1409.  
  1410. This is a standard Zoom gadget which switches the window between full
  1411. size and a title bar and the help text.
  1412.  
  1413.  
  1414.  
  1415. TSMorph.guide/I-gad-Depth
  1416.  
  1417.  
  1418. Depth gadget
  1419. ------------
  1420.  
  1421. This is a standard depth gadget.
  1422.  
  1423.  
  1424.  
  1425. TSMorph.guide/I-men
  1426.  
  1427.  
  1428. Menus on the Info Window
  1429. ========================
  1430.  
  1431. The following menus are available on the Information Window:
  1432.  
  1433.  
  1434.   Project                Project menu
  1435.  
  1436.   Settings               Settings menu
  1437.  
  1438.  
  1439.  
  1440. TSMorph.guide/I-men-P
  1441.  
  1442.  
  1443. Info Window Project menu
  1444. ------------------------
  1445.  
  1446. This menu contains the following items with their associated Amiga
  1447. short-cuts in the Info Window:
  1448.  
  1449.  
  1450.   New         N                      Create a new project
  1451.   Open...     O                      Open a file
  1452.  
  1453.   Save        S                      Save file
  1454.   Save As...                         Save named file
  1455.   Delete...                          Delete a Project
  1456.  
  1457.   About...                           Show about requester
  1458.  
  1459.   Quit        Q                      Quit program
  1460.  
  1461.   Preview...                         Preview render
  1462.   Edit Points E                      Open windows to edit points
  1463.  
  1464.  
  1465.  
  1466. TSMorph.guide/I-men-P-New
  1467.  
  1468.  
  1469. Info Window Project/New menu item
  1470. .................................
  1471.  
  1472. This menu item creates a new project.
  1473.  
  1474. If the current project has been changed but not saved then the
  1475. Unsaved Project requester  is displayed.
  1476.  
  1477.  
  1478.  
  1479. TSMorph.guide/I-men-P-Open
  1480.  
  1481.  
  1482. Info Window Project/Open menu item
  1483. ..................................
  1484.  
  1485. This menu item allows the loading of a previously created
  1486. Parameter file.
  1487.  
  1488. If the current project has been changed but not saved then the
  1489. Unsaved Project requester  is displayed.
  1490.  
  1491.  
  1492.  
  1493. TSMorph.guide/I-men-P-Save
  1494.  
  1495.  
  1496. Info Window Project/Save menu item
  1497. ..................................
  1498.  
  1499. This saves the current project using the current name. If the project
  1500. does not yet have a name then an ASL file requester is displayed.
  1501.  
  1502. See File Format.
  1503.  
  1504.  
  1505.  
  1506. TSMorph.guide/I-men-P-Save_As
  1507.  
  1508.  
  1509. Info Window Project/Save As... menu item
  1510. ........................................
  1511.  
  1512. This saves the current project using a name chosen suing an ASL file
  1513. requester.
  1514.  
  1515. See File Format.
  1516.  
  1517.  
  1518.  
  1519. TSMorph.guide/I-men-P-Delete
  1520.  
  1521.  
  1522. Info Window Project/Delete... menu item
  1523. .......................................
  1524.  
  1525. This can be used to delete a Project. It will delete the main file, its
  1526. icon (if present) and any associated Anim points files.
  1527.  
  1528. See File Format.
  1529.  
  1530.  
  1531.  
  1532. TSMorph.guide/I-men-P-About
  1533.  
  1534.  
  1535. Info Window Project/About... menu item
  1536. ......................................
  1537.  
  1538. This displays some program version information in the About Requester.
  1539.  
  1540.  
  1541.  
  1542. TSMorph.guide/I-men-P-Quit
  1543.  
  1544.  
  1545. Info Window Project/Quit menu item
  1546. ..................................
  1547.  
  1548. This quits TSMorph.
  1549.  
  1550. If the current project has been changed but not saved then the
  1551. Unsaved Project requester  is displayed.
  1552.  
  1553.  
  1554.  
  1555. TSMorph.guide/I-men-P-Preview
  1556.  
  1557.  
  1558. Info Window Project/Preview... menu item
  1559. ........................................
  1560.  
  1561. This menu item renders the image using the ARexx script supplied in the
  1562. PREVIEW  parameter.
  1563.  
  1564. If required it first displays the Frame Number  requester.
  1565.  
  1566. This menu option is only available if reqtools.library is available.
  1567.  
  1568. If the current project has been changed but not saved then the
  1569. Unsaved Project requester  is displayed.
  1570.  
  1571.  
  1572.  
  1573. TSMorph.guide/I-men-P-Edit_Points
  1574.  
  1575.  
  1576. Info Window Project/Edit Points menu item
  1577. .........................................
  1578.  
  1579. This is the same as the Edit Points  gadget.
  1580.  
  1581. It opens the Control Window  and Edit Windows  to allow editing of the
  1582. control points. If these windows are already open then the Control
  1583. Window is activated.
  1584.  
  1585.  
  1586.  
  1587. TSMorph.guide/I-Key
  1588.  
  1589.  
  1590. Keyboard controls in the Info Window
  1591. ====================================
  1592.  
  1593. The following keyboard controls are available in the Info Window:
  1594.  
  1595.      o  Activate File One  gadget
  1596.         With shift - show file requester - See Get File One.
  1597.      
  1598.      t  Activate File Two  gadget
  1599.         With shift - show file requester - See Get File Two.
  1600.      
  1601.      1  Activate 24 File 1  gadget
  1602.         With shift - show file requester - See Get 24 File 1.
  1603.      
  1604.      2  Activate 24 File 2  gadget
  1605.         With shift - show file requester - See Get 24 File 2.
  1606.      
  1607.      rR Cycle Single image  gadget.
  1608.      
  1609.      f  Activate Frames  gadget.
  1610.      
  1611.      a  Activate Start  gadget.
  1612.      
  1613.      n  Activate Name  gadget
  1614.         With shift - show file requester - See Get Name.
  1615.      
  1616.      p  Same as Edit Points  gadget
  1617.  
  1618. Help displays context sensitive help using amigaguide if available.
  1619.  
  1620.  
  1621.  
  1622. TSMorph.guide/Con
  1623.  
  1624.  
  1625. The Control Window
  1626. ******************
  1627.  
  1628. The control window displays various gadgets for different for different
  1629. point editing modes. The title bar displays the current editing mode as
  1630. does the Mouse pointer. The screen title bar displays TSMorph for
  1631. non-animated Warps/Morphs and TSMorph - Frame nnn for animated
  1632. Warps/Morphs.
  1633.  
  1634.  
  1635.   Gadgets             Gadgets displayed in the control window
  1636.   Menus               Menus on the Control Window
  1637.   Edit Modes          Point editing modes
  1638.   Keyboard            Keyboard controls in the Control Window
  1639.  
  1640.  
  1641.  
  1642. TSMorph.guide/Con-gad
  1643.  
  1644.  
  1645. Control and Image Window gadgets
  1646. ================================
  1647.  
  1648.  
  1649.      --------------
  1650.      |. | Mov |   |
  1651.      |------------|
  1652.      | ONE   TWO  |
  1653.      | REL   ADD  |
  1654.      | DEL   LNK  |
  1655.      | UNL   MOV  |
  1656.      ||< < ? > >| |
  1657.      --------------
  1658.  
  1659. Most are used to set the edit mode. The rest except the close and depth
  1660. gadgets are used to set the current Frame Number.
  1661.  
  1662.  
  1663.   One                     Move points in one window
  1664.   Two                     Move points in both windows
  1665.   Rel                     Move points relatively in both windows
  1666.   Add                     Add a new point
  1667.   Del                     Delete an existing point
  1668.   Lnk                     Link two points
  1669.   Unl                     Unlink two points
  1670.   Mov                     Scroll the window
  1671.  
  1672.   |<                      First Frame
  1673.   <                       Previous Frame
  1674.   ?                       Goto Frame
  1675.   >                       Next Frame
  1676.   >|                      Last Frame
  1677.  
  1678.   Close                   Close window
  1679.   Depth                   Depth gadget
  1680.  
  1681.  
  1682.  
  1683. TSMorph.guide/Con-gad-First
  1684.  
  1685.  
  1686. Control Window First Frame gadget
  1687. ---------------------------------
  1688.  
  1689. This gadget goes to the first frame. This is the same as the First  menu
  1690. item.
  1691.  
  1692. This gadget is disabled if the Morph/Warp is not animated, or the first
  1693. frame is already displayed.
  1694.  
  1695.  
  1696.  
  1697. TSMorph.guide/Con-gad-Previous
  1698.  
  1699.  
  1700. Control Window Previous Frame gadget
  1701. ------------------------------------
  1702.  
  1703. This gadget goes to the previous frame. This is the same as the
  1704. Previous  menu item.
  1705.  
  1706. This gadget is disabled if the Morph/Warp is not animated, or the first
  1707. frame is currently displayed.
  1708.  
  1709.  
  1710.  
  1711. TSMorph.guide/Con-gad-Goto
  1712.  
  1713.  
  1714. Control Window Goto Frame gadget
  1715. --------------------------------
  1716.  
  1717. This gadget goes to a chosen frame. This is the same as the Goto  menu
  1718. item. It displays the Frame Number  Requester.
  1719.  
  1720. This gadget is disabled if the Morph/Warp is not animated.
  1721.  
  1722.  
  1723.  
  1724. TSMorph.guide/Con-gad-Next
  1725.  
  1726.  
  1727. Control Window Next Frame gadget
  1728. --------------------------------
  1729.  
  1730. This gadget goes to the next frame. This is the same as the Next  menu
  1731. item.
  1732.  
  1733. This gadget is disabled if the Morph/Warp is not animated, or the last
  1734. frame is currently displayed.
  1735.  
  1736.  
  1737.  
  1738. TSMorph.guide/Con-gad-Last
  1739.  
  1740.  
  1741. Control Window Last Frame gadget
  1742. --------------------------------
  1743.  
  1744. This gadget goes to the last frame. This is the same as the Last  menu
  1745. item.
  1746.  
  1747. This gadget is disabled if the Morph/Warp is not animated, or the last
  1748. frame is already displayed.
  1749.  
  1750.  
  1751.  
  1752. TSMorph.guide/Con-gad-Close
  1753.  
  1754.  
  1755. Control Window Close gadget
  1756. ---------------------------
  1757.  
  1758. This closes the Control Window , and the Edit Windows.
  1759.  
  1760.  
  1761.  
  1762. TSMorph.guide/Con-gad-Depth
  1763.  
  1764.  
  1765. Control Window Depth gadget
  1766. ---------------------------
  1767.  
  1768. This is a standard depth gadget.
  1769.  
  1770.  
  1771.  
  1772. TSMorph.guide/CI-men
  1773.  
  1774.  
  1775. Control and Edit Windows menus
  1776. ==============================
  1777.  
  1778. The following menus are available on the Control  and Edit  Windows:
  1779.  
  1780.  
  1781.   Project                Project menu
  1782.  
  1783.   Edit                   Edit menu
  1784.  
  1785.   Settings               Settings menu
  1786.  
  1787.  
  1788.  
  1789. TSMorph.guide/CI-men-P
  1790.  
  1791.  
  1792. Control and Edit Windows Project menu
  1793. -------------------------------------
  1794.  
  1795. This menu contains the following items with their associated Amiga
  1796. short-cuts in the Control  and Edit  Windows:
  1797.  
  1798.  
  1799.   New Points     N                       Delete all points
  1800.   Open Points... O                       Read points from a file
  1801.  
  1802.   Save           S                       Save file
  1803.   Save As...     A                       Save named file
  1804.  
  1805.   About...                               Show about requester
  1806.  
  1807.   Exit Points                            Open windows to edit points
  1808.  
  1809.   Quit           Q                       Quit program
  1810.  
  1811.   Preview...                             Preview render
  1812.  
  1813.  
  1814.  
  1815. TSMorph.guide/CI-men-P-New
  1816.  
  1817.  
  1818. Control and Edit Window Project/New Points menu item
  1819. ....................................................
  1820.  
  1821. This menu item deletes all existing points.
  1822.  
  1823.  
  1824.  
  1825. TSMorph.guide/CI-men-P-Open
  1826.  
  1827.  
  1828. Control and Edit Window Project/Open Points menu item
  1829. .....................................................
  1830.  
  1831. This menu item allows the loading of a previously created
  1832. Parameter file.
  1833.  
  1834. Only the points are loaded from the file. Other parameters are retained.
  1835.  
  1836. If the current project has been changed but not saved then the
  1837. Unsaved Project requester  is displayed.
  1838.  
  1839.  
  1840.  
  1841. TSMorph.guide/CI-men-P-Save
  1842.  
  1843.  
  1844. Control and Edit Window Project/Save menu item
  1845. ..............................................
  1846.  
  1847. This saves the current project using the current name. If the project
  1848. does not yet have a name then an ASL file requester is displayed.
  1849.  
  1850. See File Format.
  1851.  
  1852.  
  1853.  
  1854. TSMorph.guide/CI-men-P-Save_As
  1855.  
  1856.  
  1857. Control and Edit Window Project/Save As... menu item
  1858. ....................................................
  1859.  
  1860. This saves the current project using a name chosen using an ASL file
  1861. requester.
  1862.  
  1863. See File Format.
  1864.  
  1865.  
  1866.  
  1867. TSMorph.guide/CI-men-P-About
  1868.  
  1869.  
  1870. Control and Edit Window Project/About... menu item
  1871. ..................................................
  1872.  
  1873. This displays some program version information in the About Requester.
  1874.  
  1875.  
  1876.  
  1877. TSMorph.guide/CI-men-P-Exit_Points
  1878.  
  1879.  
  1880. Control and Edit Window Project/Exit Points menu item
  1881. .....................................................
  1882.  
  1883. This is the same as closing the Control Window  or either of the
  1884. Edit Windows. It closes all of these windows.
  1885.  
  1886.  
  1887.  
  1888. TSMorph.guide/CI-men-P-Quit
  1889.  
  1890.  
  1891. Control and Edit Window Project/Quit menu item
  1892. ..............................................
  1893.  
  1894. This quits TSMorph.
  1895.  
  1896. If the current project has been changed but not saved then the
  1897. Unsaved Project requester  is displayed.
  1898.  
  1899.  
  1900.  
  1901. TSMorph.guide/CI-men-P-Preview
  1902.  
  1903.  
  1904. Control and Edit Windows Project/Preview... menu item
  1905. .....................................................
  1906.  
  1907. This menu item renders the image using the ARexx script supplied in the
  1908. PREVIEW  parameter.
  1909.  
  1910. If required it first displays the Frame Number  requester.
  1911.  
  1912. This menu option is only available if reqtools.library is available.
  1913.  
  1914. If the current project has been changed but not saved then the
  1915. Unsaved Project requester  is displayed.
  1916.  
  1917.  
  1918.  
  1919. TSMorph.guide/CI-men-E
  1920.  
  1921.  
  1922. Control and Edit Window Edit menu
  1923. ---------------------------------
  1924.  
  1925. This menu contains the following items with their associated Amiga
  1926. short-cuts in the Control  and Edit  Windows:
  1927.  
  1928.  
  1929.   Add Grid... G                       Add a grid of points
  1930.   Triangulate T                       Convert links to triangles
  1931.   Frame       »                       Change the Frame Number
  1932.   Mode        »                       Set the edit mode.
  1933.  
  1934.  
  1935.  
  1936. TSMorph.guide/CI-men-E-Grid
  1937.  
  1938.  
  1939. Control and Edit Window Edit/Add Grid... menu item
  1940. ..................................................
  1941.  
  1942. This menu item displays the Add Grid  requester to add a grid of points
  1943. to the images.
  1944.  
  1945.  
  1946.  
  1947. TSMorph.guide/CI-men-E-Triangulate
  1948.  
  1949.  
  1950. Control and Edit Window Edit/Triangulate menu item
  1951. ..................................................
  1952.  
  1953. This menu item deletes all links between points and attempts to convert
  1954. them to triangles (similar to the MODE=24  option of TSMorph-render). If
  1955. the current project has been changed then the Unsaved Project  requester
  1956. is displayed.
  1957.  
  1958.  
  1959.  
  1960. TSMorph.guide/CI-men-E-Frame
  1961.  
  1962.  
  1963. Control and Edit Windows Frame sub menu
  1964. .......................................
  1965.  
  1966. This sub menu contains the following items with their associated Amiga
  1967. short-cuts in the Control  and Edit  Windows:
  1968.  
  1969.  
  1970.   First    <                          First Frame
  1971.   Previous -                          Previous Frame
  1972.   Goto...  .                          Goto Frame
  1973.   Next     +                          Next Frame
  1974.   Last     >                          Last Frame
  1975.  
  1976.  
  1977.  
  1978. TSMorph.guide/CI-men-E-Frame-First
  1979.  
  1980.  
  1981. Control and Edit Windows Frame/First menu item
  1982. **********************************************
  1983.  
  1984. This menu item goes to the first frame. This is the same as the First 
  1985. gadget.
  1986.  
  1987. This menu item is disabled if the Morph/Warp is not animated, or the
  1988. first frame is already displayed.
  1989.  
  1990.  
  1991.  
  1992. TSMorph.guide/CI-men-E-Frame-Previous
  1993.  
  1994.  
  1995. Control and Edit Windows Frame/Previous menu item
  1996. *************************************************
  1997.  
  1998. This menu item goes to the previous frame. This is the same as the
  1999. Previous  gadget.
  2000.  
  2001. This menu item is disabled if the Morph/Warp is not animated, or the
  2002. first frame is already displayed.
  2003.  
  2004.  
  2005.  
  2006. TSMorph.guide/CI-men-E-Frame-Goto
  2007.  
  2008.  
  2009. Control and Edit Windows Frame/Goto menu item
  2010. *********************************************
  2011.  
  2012. This menu item goes to a chosen frame. This is the same as the Goto 
  2013. gadget. It displays the Frame Number  Requester.
  2014.  
  2015. This menu item is disabled if the Morph/Warp is not animated, or the
  2016. first frame is already displayed.
  2017.  
  2018.  
  2019.  
  2020. TSMorph.guide/CI-men-E-Frame-Next
  2021.  
  2022.  
  2023. Control and Edit Windows Frame/Next menu item
  2024. *********************************************
  2025.  
  2026. This menu item goes to the next frame. This is the same as the Next 
  2027. gadget.
  2028.  
  2029. This menu item is disabled if the Morph/Warp is not animated, or the
  2030. last frame is already displayed.
  2031.  
  2032.  
  2033.  
  2034. TSMorph.guide/CI-men-E-Frame-Last
  2035.  
  2036.  
  2037. Control and Edit Windows Frame/Last menu item
  2038. *********************************************
  2039.  
  2040. This menu item goes to the last frame. This is the same as the Last 
  2041. gadget.
  2042.  
  2043. This menu item is disabled if the Morph/Warp is not animated, or the
  2044. last frame is already displayed.
  2045.  
  2046.  
  2047.  
  2048. TSMorph.guide/CI-men-E-EMode
  2049.  
  2050.  
  2051. Control and Edit Window Edit/Mode sub menu
  2052. ..........................................
  2053.  
  2054. This sub menu contains the following items with their associated Amiga
  2055. short-cuts in the Control  and Edit  Windows:
  2056.  
  2057.  
  2058.   Edit One  1                 Move points in one window
  2059.   Edit Two  2                 Move points in both windows
  2060.   Edit Rel  3                 Move points relatively in both windows
  2061.   Add       4                 Add a new point
  2062.   Delete    5                 Delete an existing point
  2063.   Link      6                 Link two points
  2064.   Unlink    7                 Unlink two points
  2065.   None      8                 Scroll the window
  2066.  
  2067.  
  2068.  
  2069. TSMorph.guide/men-Settings
  2070.  
  2071.  
  2072. Settings menu
  2073. -------------
  2074.  
  2075. This menu contains the following items with their associated Amiga
  2076. short-cuts in the Control , Info  and Edit  Windows. Settings can be set
  2077. using Parameters. All menu items which display requesters will not be
  2078. available if reqtools.library is not available. Items requiring
  2079. opal.library will not be available if opal.library is not available.
  2080.  
  2081.  
  2082.   Create Icons?                         Create Icons on projects?
  2083.   Change Palette?    P                  Use Image palette?
  2084.   Zoom?              Z                  Zoom Image?
  2085.   Open Mode          »                  How to open images
  2086.   Public Screen...                      Screen for TSMorph
  2087.   Custom Mode...                        Mode of Custom screen to open
  2088.   Custom Depth...                       Depth of Custom screen to open
  2089.   Preview Script...                     ARexx preview script
  2090.  
  2091.   Create Prefs Icons?                   Create Icons on settings
  2092.   Keep Settings?                        Keep settings on Quit
  2093.   Load Settings...                      Display file requester to load settings
  2094.   Save Settings                         Save settings in ENVARC:TSMorph/TSMorph.prefs
  2095.   Save Settings As...                   Display file requester to save settings
  2096.  
  2097.   Create Render Icons?                  Create Icons on images?
  2098.   DX...                                 Horizontal skip
  2099.   DY...                                 Vertical skip
  2100.   Load Script...                        ARexx load script
  2101.   Pre Script...                         ARexx pre frame script
  2102.   Post Script...                        ARexx post frame script
  2103.   Depth                                 Morphing algorithm depth
  2104.   Mode               »                  Morphing algorithm mode
  2105.   Save Format        »                  Image save format
  2106.   JPEG Quality                          Quality of JPEG images
  2107.   Render Screen...                      Public screen for TSMorph-render
  2108.   Anti-Alias?                           Anti-Alias the output images
  2109.   Integer?                              Use integer maths
  2110.  
  2111.   Reset To Defaults                     Reset to default settings
  2112.   Last Saved                            Restore from ENVARC:TSMorph/TSMorph.prefs
  2113.   Restore                               Restore from ENV:TSMorph/TSMorph.prefs
  2114.  
  2115.   Continuous Help?                      Display continuous help
  2116.  
  2117.  
  2118.  
  2119. TSMorph.guide/men-S-LoadS
  2120.  
  2121.  
  2122. Setting/Load Settings... menu item
  2123. ..................................
  2124.  
  2125. This displays an ASL requester to load settings  into the currently
  2126. running program.
  2127.  
  2128. The default name is TSMorph.prefs.
  2129.  
  2130.  
  2131.  
  2132. TSMorph.guide/men-S-SaveS
  2133.  
  2134.  
  2135. Settings/Save Settings menu item
  2136. ................................
  2137.  
  2138. This saves the current settings  in ENVARC:TSMorph/TSMorph.prefs and
  2139. ENV:TSMorph/TSMorph.prefs.
  2140.  
  2141. If CREATEICONSP  is set then an Icon is saved as well
  2142.  
  2143. Unless KEEPSETTINGS  is set to NO current settings are saved in
  2144. ENV:TSMorph/TSMorph.prefs whenever TSMorph is quit.
  2145.  
  2146.  
  2147.  
  2148. TSMorph.guide/men-S-SaveSAs
  2149.  
  2150.  
  2151. Setting/Save Settings As... menu item
  2152. .....................................
  2153.  
  2154. This displays an ASL requester to save the current settings.
  2155.  
  2156. If CREATEICONSP  is set then an Icon is saved as well
  2157.  
  2158. The default name is TSMorph.prefs.
  2159.  
  2160.  
  2161.  
  2162. TSMorph.guide/men-S-ResetD
  2163.  
  2164.  
  2165. Setting/Reset To Defaults menu item
  2166. ...................................
  2167.  
  2168. This resets settings  to there default values.
  2169.  
  2170. If some Image windows  are open and CHANGEPALETTE  is set to OFF then it
  2171. will stay OFF. The same applies to ZOOM.
  2172.  
  2173.  
  2174.  
  2175. TSMorph.guide/men-S-LastS
  2176.  
  2177.  
  2178. Settings/Last Saved menu item
  2179. .............................
  2180.  
  2181. This reset settings  to the values last saved in
  2182. ENVARC:TSMorph/TSMorph.prefs (overridden by any Tool Types).
  2183.  
  2184. If some Image windows  are open and CHANGEPALETTE  is set to OFF then it
  2185. will stay OFF. The same applies to ZOOM.
  2186.  
  2187.  
  2188.  
  2189. TSMorph.guide/men-S-Restore
  2190.  
  2191.  
  2192. Setting/Restore menu item
  2193. .........................
  2194.  
  2195. This resets settings  to the values last saved in
  2196. ENV:TSMorph/TSMorph.prefs (overridden by any Tool Types). Settings are
  2197. saved in this file whenever TSMorph is quit if KEEPSETTINGS  is set to
  2198. YES.
  2199.  
  2200. If some Image windows  are open and CHANGEPALETTE  is set to OFF then it
  2201. will stay OFF. The same applies to ZOOM.
  2202.  
  2203.  
  2204.  
  2205. TSMorph.guide/Con-Key
  2206.  
  2207.  
  2208. Keyboard controls in the Control Window
  2209. =======================================
  2210.  
  2211. Help displays context sensitive help using amigaguide if available.
  2212.  
  2213.  
  2214.  
  2215. TSMorph.guide/Edit
  2216.  
  2217.  
  2218. The Edit Windows
  2219. ****************
  2220.  
  2221. The Edit windows display Workbench displayable versions of the images
  2222. to be morphed along with the control points. The window title displays
  2223. the file name, the screen title displays the full file name. The mouse
  2224. pointer shows the current editing mode. The windows are sizeable and
  2225. have scrollbars. The menus displayed are the same as the Control Window.
  2226.  
  2227. The first click in these windows is ignored.
  2228.  
  2229. If EGS  is being used then the windows are displayed on the EGS screen
  2230. without menus. Keyboard short cuts 1-8 are still available. The windows
  2231. do not, however, automatically scroll.
  2232.  
  2233.  
  2234.   Gadgets          Gadgets on the Edit Windows
  2235.   Menus            Menus on the Edit Windows
  2236.   Keyboard         Keyboard controls on the Edit Windows
  2237.   Modes            Point editing modes.
  2238.  
  2239.  
  2240.  
  2241. TSMorph.guide/E-gad
  2242.  
  2243.  
  2244. Gadgets on the Edit Windows
  2245. ===========================
  2246.  
  2247.  
  2248.      --------------------
  2249.      |. |filename |  |  |
  2250.      |------------------|
  2251.      |              |   |
  2252.      |              ||| |
  2253.      |              ||| |
  2254.      |              ||| |
  2255.      |              ||| |
  2256.      |              |/| |
  2257.      |              |\| |
  2258.      |------------------|
  2259.      |------- <- -> |// |
  2260.      --------------------
  2261.  
  2262.  
  2263.   Horizontal scroll gadget              Scrolls image horizontally
  2264.   Vertical scroll gadget                Scrolls image vertically
  2265.   Up gadget                             Scroll image up
  2266.   Down gadget                           Scroll image down
  2267.   Left gadget                           Scroll image left
  2268.   Right gadget                          Scroll image right
  2269.  
  2270.   Close gadget                          Close Edit and Control Windows
  2271.   Zoom gadget                           Zoom window
  2272.   Depth gadget                          Depth gadget
  2273.   Sizing gadget                         Sizing gadget
  2274.  
  2275.  
  2276.  
  2277. TSMorph.guide/E-gad-Horiz
  2278.  
  2279.  
  2280. Edit Windows Horizontal gadget
  2281. ------------------------------
  2282.  
  2283. This gadget can be used to scroll the image horizontally.
  2284.  
  2285.  
  2286.  
  2287. TSMorph.guide/E-gad-Vert
  2288.  
  2289.  
  2290. Edit Windows Vertical gadget
  2291. ----------------------------
  2292.  
  2293. This gadget can be used to scroll the image vertically.
  2294.  
  2295.  
  2296.  
  2297. TSMorph.guide/E-gad-Up
  2298.  
  2299.  
  2300. Edit Windows Up gadget
  2301. ----------------------
  2302.  
  2303. This gadget can be used to scroll the image up.
  2304.  
  2305. Holding down shift will cause the window to scroll one pixel at a time.
  2306.  
  2307.  
  2308.  
  2309. TSMorph.guide/E-gad-Down
  2310.  
  2311.  
  2312. Edit Windows Down gadget
  2313. ------------------------
  2314.  
  2315. This gadget can be used to scroll the image down.
  2316.  
  2317. Holding down shift will cause the window to scroll one pixel at a time.
  2318.  
  2319.  
  2320.  
  2321. TSMorph.guide/E-gad-Left
  2322.  
  2323.  
  2324. Edit Windows Left gadget
  2325. ------------------------
  2326.  
  2327. This gadget can be used to scroll the image left.
  2328.  
  2329. Holding down shift will cause the window to scroll one pixel at a time.
  2330.  
  2331.  
  2332.  
  2333. TSMorph.guide/E-gad-Right
  2334.  
  2335.  
  2336. Edit Windows Right gadget
  2337. -------------------------
  2338.  
  2339. This gadget can be used to scroll the image right.
  2340.  
  2341. Holding down shift will cause the window to scroll one pixel at a time.
  2342.  
  2343.  
  2344.  
  2345. TSMorph.guide/E-gad-Close
  2346.  
  2347.  
  2348. Edit Windows Close gadget
  2349. -------------------------
  2350.  
  2351. This closes the Control Window , and the Edit Windows.
  2352.  
  2353.  
  2354.  
  2355. TSMorph.guide/E-gad-Zoom
  2356.  
  2357.  
  2358. Edit Windows Zoom gadget
  2359. ------------------------
  2360.  
  2361. This is a standard Zoom gadget. It swaps the size between maximum and
  2362. minimum
  2363.  
  2364. Maximum is the smaller of the size of the image or the size of the
  2365. screen.
  2366.  
  2367. Minimum is the minimum required for all gadgets to still be visible.
  2368.  
  2369.  
  2370.  
  2371. TSMorph.guide/E-gad-Depth
  2372.  
  2373.  
  2374. Edit Windows Depth gadget
  2375. -------------------------
  2376.  
  2377. This is a standard depth gadget.
  2378.  
  2379.  
  2380.  
  2381. TSMorph.guide/E-gad-Size
  2382.  
  2383.  
  2384. Edit Windows Sizing gadget
  2385. --------------------------
  2386.  
  2387. This a standard sizing gadget. See Zoom  gadget for the sizing limits
  2388.  
  2389.  
  2390.  
  2391. TSMorph.guide/E-Key
  2392.  
  2393.  
  2394. Keyboard controls in the Edit Windows
  2395. =====================================
  2396.  
  2397. The number keys can be used to set the Edit Mode.
  2398.  
  2399.  
  2400.   1                 Move points in one window
  2401.   2                 Move points in both windows
  2402.   3                 Move points relatively in both windows
  2403.   4                 Add a new point
  2404.   5                 Delete an existing point
  2405.   6                 Link two points
  2406.   7                 Unlink two points
  2407.   8                 Scroll the window
  2408.  
  2409. Help displays context sensitive help using amigaguide if available.
  2410.  
  2411.  
  2412.  
  2413. TSMorph.guide/EModes
  2414.  
  2415.  
  2416. Point editing modes
  2417. *******************
  2418.  
  2419. The following edit modes are available to edit points:
  2420.  
  2421.  
  2422.   One                      Move points in one window
  2423.   Two                      Move points in both windows
  2424.   Relative                 Move points relatively in both windows
  2425.   Add                      Add a new point
  2426.   Delete                   Delete an existing point
  2427.   Link                     Link two points
  2428.   Unlink                   Unlink two points
  2429.   Move                     Scroll the window
  2430.  
  2431. Note: The menu button can always be used to abort the current operation
  2432. before releasing the select button.
  2433.  
  2434. Modes can be set using gadgets in the Control Window  or by using menus 
  2435. on the Control  and Edit  Windows.
  2436.  
  2437.  
  2438.  
  2439. TSMorph.guide/EMode-One
  2440.  
  2441.  
  2442. Edit Mode One
  2443. =============
  2444.  
  2445. This mode is used to move a point in one of the Edit Windows.
  2446.  
  2447. The Control Windows  title is set to One.
  2448.  
  2449. The Mouse Pointer is set to ONE.
  2450.  
  2451. Points can be clicked and moved in either of the windows with the mouse
  2452. - the point will only move in the selected window.
  2453.  
  2454.  
  2455.  
  2456. TSMorph.guide/EMode-Two
  2457.  
  2458.  
  2459. Edit Mode Two
  2460. =============
  2461.  
  2462. This mode is used to move a point in both of the Edit Windows.
  2463.  
  2464. The Control Windows  title is set to Two.
  2465.  
  2466. The Mouse Pointer is set to TWO.
  2467.  
  2468. Points can be clicked and moved in both of the windows with the mouse -
  2469. the point will move in both windows to the same absolute position.
  2470.  
  2471.  
  2472.  
  2473. TSMorph.guide/EMode-Relative
  2474.  
  2475.  
  2476. Edit Mode Relative
  2477. ==================
  2478.  
  2479. This mode is used to move a point in both of the Edit Windows.
  2480.  
  2481. The Control Windows  title is set to Rel.
  2482.  
  2483. The Mouse Pointer is set to REL.
  2484.  
  2485. Points can be clicked and moved in both of the windows with the mouse -
  2486. the point will move in both windows to the same relative position.
  2487.  
  2488.  
  2489.  
  2490. TSMorph.guide/EMode-Add
  2491.  
  2492.  
  2493. Edit Mode Add
  2494. =============
  2495.  
  2496. This mode is used to add a point in both of the Edit Windows.
  2497.  
  2498. The Control Windows  title is set to Add.
  2499.  
  2500. The Mouse Pointer is set to ADD.
  2501.  
  2502. Points can be added in either of the windows by clicking the mouse - the
  2503. point will added to both windows to the same absolute position.
  2504.  
  2505.  
  2506.  
  2507. TSMorph.guide/EMode-Delete
  2508.  
  2509.  
  2510. Edit Mode Delete
  2511. ================
  2512.  
  2513. This mode is used to delete a point in both of the Edit Windows.
  2514.  
  2515. The Control Windows  title is set to Del.
  2516.  
  2517. The Mouse Pointer is set to DEL.
  2518.  
  2519. Points can be deleted in either of the windows by clicking the mouse -
  2520. the point will deleted from both windows. Any links  will also be
  2521. removed.
  2522.  
  2523.  
  2524.  
  2525. TSMorph.guide/EMode-Link
  2526.  
  2527.  
  2528. Edit Mode Link
  2529. ==============
  2530.  
  2531. This mode is used to link two points in both of the Edit Windows.
  2532.  
  2533. The Control Windows  title is initially set to L1.
  2534.  
  2535. The Mouse Pointer is set to L1.
  2536.  
  2537. A point can then be selected in either of the windows by clicking the
  2538. mouse.
  2539.  
  2540. The Control Windows  title is then set to L2.
  2541.  
  2542. The Mouse Pointer is set to L2.
  2543.  
  2544. Another point can then be selected in either of the windows by clicking
  2545. the mouse. The points will be joined by a line.
  2546.  
  2547. Note: this line is to enable points to be identified more easily. It is
  2548. not used by the rendering process.
  2549.  
  2550.  
  2551.  
  2552. TSMorph.guide/EMode-Unlink
  2553.  
  2554.  
  2555. Edit Mode Unlink
  2556. ================
  2557.  
  2558. This mode is used to unlink two linked points in both of the
  2559. Edit Windows.
  2560.  
  2561. The Control Windows  title is initially set to U1.
  2562.  
  2563. The Mouse Pointer is set to U1.
  2564.  
  2565. A point can then be selected in either of the windows by clicking the
  2566. mouse.
  2567.  
  2568. The Control Windows  title is then set to U2.
  2569.  
  2570. The Mouse Pointer is set to U2.
  2571.  
  2572. Another point can then be selected in either of the windows by clicking
  2573. the mouse. If the points are currently joined then the line will be
  2574. removed.
  2575.  
  2576.  
  2577.  
  2578. TSMorph.guide/EMode-Move
  2579.  
  2580.  
  2581. Edit Mode Move
  2582. ==============
  2583.  
  2584. In this mode no points are edited.
  2585.  
  2586. The Control Windows  title is set to Mov.
  2587.  
  2588. The Mouse Pointer is set to Mov.
  2589.  
  2590. Clicking in the window and moving the mouse will scroll the window.
  2591.  
  2592. This is the initial mode when the Edit Windows  are opened.
  2593.  
  2594. If EGS  is being used then the windows will not scroll.
  2595.  
  2596.  
  2597.  
  2598. TSMorph.guide/Req
  2599.  
  2600.  
  2601. Requesters which appear
  2602. ***********************
  2603.  
  2604. The following requesters are produced:
  2605.  
  2606.  
  2607.   Unsaved Project                  Quitting having not saved
  2608.   About requester                  Version Information
  2609.   Error requester                  Error messages
  2610.   Add Grid                         Add a grid of points
  2611.   Frame Number?                    Choose a Frame Number
  2612.  
  2613.   Progress                         Progress
  2614.   Really quit?                     Really quit?
  2615.  
  2616.  
  2617.  
  2618. TSMorph.guide/Req-Unsaved
  2619.  
  2620.  
  2621. Unsaved project requester
  2622. =========================
  2623.  
  2624. This requester is displayed when attempting to quit, preview render or
  2625. triangulate without having saved a project.
  2626.  
  2627. It displays 3 or 4 options (depending on if amigaguide is available):
  2628.  
  2629.      Save:    Save the project and quit, render or triangulate
  2630.      Help:    Display help (only shown if available)
  2631.      Abandon: Quit, preview or triangulate without saving the project
  2632.      Cancel:  Do not save and do not quit, preview or triangulate
  2633.  
  2634. If reqtools.library(38) is available then this will be used and
  2635. keyboard short-cuts (the first character of the option) will be
  2636. available and underlined.
  2637.  
  2638.  
  2639.  
  2640. TSMorph.guide/Req-About
  2641.  
  2642.  
  2643. About requester
  2644. ===============
  2645.  
  2646. This requester is displayed when About... is chosen on a menu on the
  2647. Info Window  or Control or Edit Windows. It displays version information.
  2648.  
  2649. If reqtools.library(38) is available then this will be used and
  2650. keyboard short-cuts (the first character of the option) will be
  2651. available and underlined.
  2652.  
  2653.  
  2654.  
  2655. TSMorph.guide/Req-Error
  2656.  
  2657.  
  2658. Error requesters
  2659. ================
  2660.  
  2661. This requester is displayed if an error occurs. It displays an error
  2662. message and gives one (or two) options.
  2663.  
  2664. If amigaguide is available then the first option will be Help - this
  2665. will display detailed information on the error message.
  2666.  
  2667. The last option is Quit for fatal errors, and OK for non fatal errors.
  2668.  
  2669. See Errors  for details on error messages.
  2670.  
  2671. If reqtools.library(38) is available then this will be used and
  2672. keyboard short-cuts (the first character of the option) will be
  2673. available and underlined.
  2674.  
  2675. If EGS  is being used and the edit  windows are open then the requester
  2676. will appear on the EGS screen.
  2677.  
  2678.  
  2679.  
  2680. TSMorph.guide/Req-Add_Grid
  2681.  
  2682.  
  2683. Add Grid requester
  2684. ==================
  2685.  
  2686. Add Grid...  menu item is chosen
  2687.  
  2688.      ----------------
  2689.      |. |Add Grid|  |
  2690.      |--------------|
  2691.      | X Cells ...  |
  2692.      | Y Cells ...  |
  2693.      |              |
  2694.      |  OK   Cancel |
  2695.      ----------------
  2696.  
  2697. The following gadgets are displayed in the requester with their
  2698. associated keyboard equivalents:
  2699.  
  2700.  
  2701.   X Cells   X                           Set number of X cells
  2702.   Y Cells   Y                           Set number of Y Cells
  2703.   OK        O                           Add points
  2704.   Cancel    C                           Cancel requester
  2705.   Close                                 Close gadget
  2706.   Depth                                 Depth gadget
  2707.  
  2708.  
  2709.  
  2710. TSMorph.guide/Req-Add_Grid-gad-X_Cells
  2711.  
  2712.  
  2713. Add Grid X Cells gadget
  2714. -----------------------
  2715.  
  2716. This gadget is used to input the number of horizontal cells of points
  2717. to add. The minimum number is 1. The default value displayed is 5.
  2718.  
  2719. This gadget can be activated by using the X key.
  2720.  
  2721.  
  2722.  
  2723. TSMorph.guide/Req-Add_Grid-gad-Y_Cells
  2724.  
  2725.  
  2726. Add Grid Y Cells gadget
  2727. -----------------------
  2728.  
  2729. This gadget is used to input the number of vertical cells of points to
  2730. add. The minimum number is 1. The default value displayed is 5.
  2731.  
  2732. This gadget can be activated by using the Y key.
  2733.  
  2734.  
  2735.  
  2736. TSMorph.guide/Req-Add_Grid-gad-OK
  2737.  
  2738.  
  2739. Add Grid OK gadget
  2740. ------------------
  2741.  
  2742. Selecting this gadget adds points of cells to the images. The number of
  2743. horizontal cells can be set in the X Cells  gadget and the number of
  2744. vertical cells in the Y Cells  gadget.
  2745.  
  2746. The O key is the same as using this gadget.
  2747.  
  2748.  
  2749.  
  2750. TSMorph.guide/Req-Add_Grid-gad-Cancel
  2751.  
  2752.  
  2753. Add Grid Cancel gadget
  2754. ----------------------
  2755.  
  2756. This gadget cancels the Add Grid requester without adding any points.
  2757.  
  2758. The C key is the same as using this gadget.
  2759.  
  2760.  
  2761.  
  2762. TSMorph.guide/Req-Add_Grid-gad-Close
  2763.  
  2764.  
  2765. Add Grid Close gadget
  2766. ---------------------
  2767.  
  2768. This is the same as the Cancel  gadget and cancels the requester.
  2769.  
  2770.  
  2771.  
  2772. TSMorph.guide/Req-Add_Grid-gad-Depth
  2773.  
  2774.  
  2775. Add Grid Depth gadget
  2776. ---------------------
  2777.  
  2778. This is a standard depth gadget.
  2779.  
  2780.  
  2781.  
  2782. TSMorph.guide/Req-FrameNumber
  2783.  
  2784.  
  2785. Choose a Frame Number requester
  2786. ===============================
  2787.  
  2788. This requester is displayed when the Edit Points  gadget is selected
  2789. (and there is more than one frame) on an animated Morph/Warp, or the
  2790. Goto  gadget or Goto  menu item is selected, or the Preview...  or
  2791. Preview...  menu item is selected.
  2792.  
  2793. It displays the first and last frame number and allows input of the
  2794. required frame number.
  2795.  
  2796. It displays OK, Help (if amigaguide is available) and Cancel gadgets.
  2797. The keyboard shortcuts (O,H and C) are underlined.
  2798.  
  2799.  
  2800.  
  2801. TSMorph.guide/Req-Progress
  2802.  
  2803.  
  2804. Progress requester
  2805. ==================
  2806.  
  2807. This requester is displayed by TSMorph-render. It shows a list view of
  2808. information messages, and the current frame and line being calculated.
  2809.  
  2810. It also displays a stop button and a zoom and depth gadget.
  2811.  
  2812. The stop gadget is checked every line. Clicking it displays the
  2813. Really quit?  requester allowing the program to be stopped.
  2814.  
  2815. The Help key displays help.
  2816.  
  2817.  
  2818.  
  2819. TSMorph.guide/Req-Really_quit
  2820.  
  2821.  
  2822. Really quit? requester
  2823. ======================
  2824.  
  2825. This requester is displayed when the stop gadget is clicked on the
  2826. Progress  requester.  It displays two (or three) options Quit (Help) and
  2827. Continue.  Quit quits the program, Continue restarts the calculation,
  2828. Help is displayed if amigaguide is available and displays help.
  2829.  
  2830. If reqtools.library(38) is available then this will be used and
  2831. keyboard short-cuts (the first character of the option) will be
  2832. available and underlined.
  2833.  
  2834.  
  2835.  
  2836. TSMorph.guide/Interface
  2837.  
  2838.  
  2839. Changing the Interface
  2840. **********************
  2841.  
  2842. All the gadgets in the Control  window, and the mouse pointers can be
  2843. edited.
  2844.  
  2845. The brushes are stored in the directory Brush/. All may be edited and
  2846. using e.g. DPaint.
  2847.  
  2848. The following brushes are size 38x34:
  2849.  
  2850.      add
  2851.      del
  2852.      link
  2853.      none
  2854.      one
  2855.      rel
  2856.      two
  2857.      unlink
  2858.  
  2859. The following are 15x15:
  2860.  
  2861.      1st
  2862.      Last
  2863.      Next
  2864.      Prev
  2865.  
  2866. The following is 16x15:
  2867.  
  2868.      Goto
  2869.  
  2870. The mouse pointers are stored in the directory Cursor/. All may be
  2871. edited using the Workbench Pointer editor.
  2872.  
  2873. The following Pointers can be edited:
  2874.  
  2875.      Xadd
  2876.      Xdel
  2877.      Xl1
  2878.      Xl2
  2879.      Xmov
  2880.      Xone
  2881.      Xrel
  2882.      Xtwo
  2883.      Xu1
  2884.      Xu2
  2885.  
  2886.  
  2887.  
  2888. TSMorph.guide/File_Format
  2889.  
  2890.  
  2891. Internal file formats
  2892. *********************
  2893.  
  2894. The file format is subject to change at any time.
  2895.  
  2896. The current format for the main file is:
  2897.  
  2898.      TSMorph 1.2
  2899.      file_name_one
  2900.      file_name_two
  2901.      24_bit_file_name_1
  2902.      24_bit_file_name_2
  2903.      anim_file_name
  2904.      w=a,h=b,Frames=c,Single=d,Start=e
  2905.      x=n,y=m,x1=o,y1=p
  2906.      .
  2907.      .
  2908.      .
  2909.      p1=i,p2=j
  2910.      .
  2911.      .
  2912.      .
  2913.  
  2914. where TSMorph 1.2 is a header record (not present in the previous
  2915. version of TSMorph, old formats can still be loaded producing a
  2916. warning message ), a is the width, b the height, c the number of frames,
  2917. d is 0 for Morph, 1 for Warp, 2 for Anim Morph and 3 for Anim Warp, e
  2918. is the start frame number, n,m are coordinates on the first image, o,p
  2919. on the second image, and i and j are the number of the points to join
  2920. (starting from 0).
  2921.  
  2922. For animated Warps and Morphs the main file contains no points. Each
  2923. frame has a set of points held in a file named with .nnn after the main
  2924. file name, where nnn is the frame number. This file has a header of
  2925. TSMorph 2.0 and then has the Points details.
  2926.  
  2927.  
  2928.  
  2929. TSMorph.guide/AR
  2930.  
  2931.  
  2932. ARexx interface to TSMorph-render and TSMorph
  2933. *********************************************
  2934.  
  2935. ARexx scripts are run before and after each image is rendered, and
  2936. before each 24 bit image is loaded. The script names can be supplied as
  2937. parameters (LOADSCRIPT , PRESCRIPT  and POSTSCRIPT ) to TSMorph-render.
  2938.  
  2939. An ARexx script can also be run by TSMorph to preview render an image.
  2940. The script name is supplied in the PREVIEW  parameter.
  2941.  
  2942. The suffix to each ARexx script should be .TSM.
  2943.  
  2944.  
  2945.   Loadscript                Run before loading 24 bit image
  2946.   Prescript                 Run before rendering
  2947.   Postscript                Run after rendering
  2948.  
  2949.   Preview                   Preview render an image
  2950.  
  2951.  
  2952.  
  2953. TSMorph.guide/AR-Loadscript
  2954.  
  2955.  
  2956. ARexx script run before loading 24 bit image
  2957. ============================================
  2958.  
  2959. This script is run before each 24 bit ILBM image is loaded.
  2960.  
  2961. It is passed the following parameters:
  2962.  
  2963.      Frame       : The current frame number, starting at Start.
  2964.      TotalFrames : The total number of frames being rendered.
  2965.      Single      : Set to 1 if a Warp, 0 for a Morph, 2 for Anim Morph, 3 for Anim Warp.
  2966.      Image       : Set to 0 for 1st image, 1 for second.
  2967.      FileName    : Name of file just rendered.
  2968.  
  2969. This script can be used to change the format of the input file (by
  2970. running it through a conversion program).
  2971.  
  2972. One example is included:
  2973.      Loadscript.TSM  - Do nothing example
  2974.  
  2975.  
  2976.  
  2977. TSMorph.guide/AR-Prescript
  2978.  
  2979.  
  2980. ARexx script run before rendering
  2981. =================================
  2982.  
  2983. This script is run before each image is rendered.
  2984.  
  2985. It is also called for the first image (for warps and morphs) and for
  2986. the last image (for morphs). By default the first and last frames are
  2987. not rendered. Produce will need to be set to 1 to output these frames.
  2988. This allows the first and last frames to be converted to the same
  2989. format as the other output images.
  2990.  
  2991. It is passed one parameter - Base - the address of a structure which
  2992. contains the following:
  2993.  
  2994.      Frame       = 0  : The current frame number, starting at 1 (0 for 1st frame) - read only.
  2995.      TotalFrames = 1  : The total number of frames being rendered - read only.
  2996.      Single      = 2  : Set to 1 if a Warp, 0 = Morph, 2 = Anim Morph, 3 = Anim Warp - read only.
  2997.      Movement    = 3  : 0 to 1024 - the proportion of movement from first to second image.
  2998.      Red1        = 4  : 0 to 1024 - the proportion of Image 1 Red to use.
  2999.      Green1      = 5  : As Red1 for Green.
  3000.      Blue1       = 6  : As Red1 for Blue.
  3001.      Red2        = 7  : 0 to 1024 - the proportion of Image 2 Red to use.
  3002.      Green2      = 8  : As Red2 for Green.
  3003.      Blue2       = 9  : As Red2 for Blue.
  3004.      Produce     = 10 : Set to 0 to not render this frame, 1 otherwise.
  3005.      RPlus       = 11 : 0 to 255 to add to Red in rendered image.
  3006.      GPlus       = 12 : As RPlus for Green.
  3007.      BPlus       = 13 : As RPlus for Blue.
  3008.      RMinus      = 14 : 0 to 255 to subtract from Red in rendered image.
  3009.      GMinus      = 15 : As RMinus for Green.
  3010.      BMinus      = 16 : As RMinus for Blue.
  3011.      DX          = 17 : 0 to ? - X amount to skip - See parameters.
  3012.      DY          = 18 : 0 to ? - Y amount to skip - See parameters.
  3013.      Start       = 19 : Starting frame number.
  3014.  
  3015. The values of these parameters may be set and read using the GetValue
  3016. and StoreValue functions:
  3017.  
  3018.      /* To read the value of e.g. Movement use:
  3019.         integer_variable = GetValue(Base,Movement)
  3020.      */
  3021.      
  3022.      /* To set the value of e.g. Produce to 0 use:
  3023.         call StoreValue(Base,Produce,0)
  3024.      */
  3025.      
  3026.      GetValue:Procedure
  3027.         Parse arg XBase, XAdd
  3028.         return C2D(IMPORT(D2C(STRIP(XBase) + (STRIP(Xadd) * 4)),4))
  3029.      
  3030.      StoreValue:Procedure
  3031.         Parse arg XBase, XAdd, XVal
  3032.         call EXPORT(D2C(STRIP(XBase) + (STRIP(Xadd) * 4)),RIGHT(D2C(XVal),4,D2C(0)),4)
  3033.         return
  3034.  
  3035. The default values passed to the script for modification are:
  3036.  
  3037.      Movement            : (1024 * Frame)/(TotalFrames + 1) Morphs
  3038.                            (1024 * Frame)/TotalFrames       Warps
  3039.      
  3040.      Red1,Green1,Blue1   : Movement                         Morphs
  3041.                            1024                             Warps
  3042.      
  3043.      Red2,Green2,Blue2   : (1024 - Movement)                Morphs
  3044.                            0                 Irrelevant for Warps
  3045.      
  3046.      Produce             : 1                                Rendered frames
  3047.                            0                 Frames 0 and TotalFrames+1
  3048.      RPlus,GPlus,BPlus   : 0
  3049.      RMinus,GMinus,BMinus: 0
  3050.      DX,DY               : Initially set by DX  and DY  parameters
  3051.  
  3052. Changing these values allows acceleration of movement, colour fades
  3053. etc. and the generation of only some images (to check a long animation).
  3054.  
  3055. Example scripts included are:
  3056.      FadeToBlack.TSM  - Warp fade to black
  3057.      FadeToWhite.TSM  - Warp fade to white
  3058.      PixelMorph.TSM   - Morph by pixelating
  3059.      PixelWarp.TSM    - Warp pixelating
  3060.      PreAll.TSM       - Render all images
  3061.      Prescript.TSM    - Do nothing example
  3062.  
  3063.  
  3064.  
  3065. TSMorph.guide/AR-Postscript
  3066.  
  3067.  
  3068. ARexx script run after rendering
  3069. ================================
  3070.  
  3071. This script is run after each image is rendered.
  3072.  
  3073. It is passed the following parameters:
  3074.  
  3075.      Frame       : The current frame number, starting at Start.
  3076.      TotalFrames : The total number of frames being rendered.
  3077.      Single      : Set to 1 if a Warp, 0 for a Morph.
  3078.      FileName    : Name of file just rendered.
  3079.  
  3080. This script can be used to change the format of the output file (by
  3081. running it through a conversion program) or build an animation.
  3082.  
  3083. Three examples are included:
  3084.      PostAnim.TSM    - Convert to Anim
  3085.      Postscript.TSM  - Do nothing example
  3086.      ToHam.TSM       - Convert using PPM and Wasp
  3087.  
  3088.  
  3089.  
  3090. TSMorph.guide/AR-Preview
  3091.  
  3092.  
  3093. ARexx script to preview render
  3094. ==============================
  3095.  
  3096. This script is run if the Preview...  or Preview...  menu item is
  3097. selected. Its purpose is to preview render the image (it can actually do
  3098. anything you like).
  3099.  
  3100. Before being called the current Settings  are saved in T:TSMorph.prefs.
  3101.  
  3102. It is passed the following parameters:
  3103.  
  3104.      Frame    : The frame number to render
  3105.      FileName : The file name of the points file
  3106.  
  3107. Two examples are included:
  3108.      Preview.TSM  - Render and display 16 grey scale image
  3109.      PreAnim.TSM  - Render and display 16 grey scale Anim
  3110.  
  3111.  
  3112.  
  3113. TSMorph.guide/Algorithms
  3114.  
  3115.  
  3116. Morphing algorithms
  3117. *******************
  3118.  
  3119. The morphing algorithm is defined using the parameters MODE  and DEPTH 
  3120. to TSMorph-render.
  3121.  
  3122. The basic algorithm is to find 3 points which make a triangle around
  3123. the point and morph this triangle between the start and end images.
  3124.  
  3125. The DEPTH  parameter controls how many points will be checked to form a
  3126. triangle. 0 means just the closest 3 points are examined, 1 the closest
  3127. 4, 2 the closest 5 etc.
  3128.  
  3129. The MODE  parameter controls both which triangle is chosen and what to
  3130. do if no surrounding triangle is found.
  3131.  
  3132. If MODE=0 2 4 ... 30 (i.e. bit 1 not set [do not add 1]) then if no
  3133. triangle surrounding the point is found examining the closest points
  3134. then the 3 closest points are used to decide how to morph. Otherwise
  3135. the point is assumed to be stationery.
  3136.  
  3137. If MODE=2 3 6 7 ... 30 31 (i.e. bit 2 set [add 2]) then all the closest
  3138. points (the exact number controlled by DEPTH ) are examined to determine
  3139. the smallest triangle. Otherwise the first surrounding triangle found is
  3140. used.
  3141.  
  3142. If MODE=4 5 6 7 12 ... (i.e. bit 3 set [add 4]) then a square algorithm
  3143. is used to find the closest points. Otherwise all points are examined.
  3144. Although using these MODEs could theoretically make the program run
  3145. faster, it seems to generally run slower.
  3146.  
  3147. If MODE=8 9 10 ... (i.e. bit 4 set [add 8]) then a Delauany triangle
  3148. algorithm is used to find triangles. For these modes the DEPTH  parameter
  3149. should normally be set to 0. Also floating point calculations are still
  3150. done even if INTEGER  is set to YES.
  3151.  
  3152. If MODE=16 17 ... (i.e. bit 8 set [add 16]) then the closest triangles
  3153. are only calculated once at the start (based on the average of start
  3154. and end). This should only be used if the points do not move a lot
  3155. between the start and end images. It can speed things up a lot for a
  3156. lot of frames. It does not make sense to use this for Animated
  3157. Warps/Morphs. This uses a lot of memory:
  3158.  
  3159.          (DEPTH + 4) * Image_Width * Image_Height * 4
  3160.      
  3161.          e.g. 640x512 image, DEPTH=2 uses 7.5 MB (contiguous) memory
  3162.  
  3163. Therefore MODEs 0 and 1 should be faster than modes 2 or 3. The DEPTH 
  3164. parameter can also have a major effect on the rendering speed.
  3165.  
  3166. See Benchmarks.
  3167.  
  3168.  
  3169.  
  3170. TSMorph.guide/Benchmarks
  3171.  
  3172.  
  3173. Benchmarks
  3174. ==========
  3175.  
  3176. These benchmarks are based on a Morph provided by "Al Bet Sam That I'm
  3177. Not Eloquent, Nancy Colours Eggs" <91016@tayloru.edu> of two 150x150
  3178. images with 41 control points.
  3179.  
  3180. Times are in seconds to generate the first frame on a 28MHz 68040
  3181. running in 32bit fast ram.
  3182.  
  3183.                 ----------------------------------------------
  3184.                 | 040 version  | 881 version  | 000 version  | Note all running on a 68040
  3185.                 ----------------------------------------------
  3186.                 |INT |   FPU   |INT |   FPU   |INT |   FPU   |   INTEGER=YES/NO/NO
  3187.      ---------------------------------------------------------
  3188.      |MODE|DEPTH|    |    | AA |    |    | AA |    |    | AA | ANTIALIAS=NO/NO/YES
  3189.      ---------------------------------------------------------
  3190.      |  0 |  0  | 6.2| 9.1|13.9|    |11.9|    |    |    |    | Shows the effect of DEPTH
  3191.      |    |  5  |12.0|15.2|    |    |    |    |    |    |    |
  3192.      ---------------------------------------------------------
  3193.      |  0 |  2  | 8.4|11.4|17.0| 8.8|14.1|18.5| 9.4|63.8|80.9| On a 68000 with 1MB chip ram, no
  3194.      |  1 |     | 8.1|    |    | 8.5|    |    |   x|    |    | fast ram...
  3195.      |  2 |     | 8.9|    |    |    |    |    |    |    |    |
  3196.      |  4 |     |13.4|    |22.8|13.6|    |23.3|    |    |    | x = 262  (9.4 * 28)
  3197.      |  8 |     | 7.6|    |    |    |    |    |    |    |    |
  3198.      | 16 |     | 2.8|    |10.7|    |    |12.1|    |    |    |
  3199.      | 17 |     | 2.5|    | 8.9| 2.6|    |10.3| 3.2|    |45.5|
  3200.      ---------------------------------------------------------
  3201.      |  8 |  0  | 6.4|    |    |    |    |    |    |    |    |
  3202.      ---------------------------------------------------------
  3203.      | 15 |  0  | 7.1|    |    |    |    |    |    |    |    |
  3204.      ---------------------------------------------------------
  3205.      | 16 |  0  | 1.7| 4.6| 9.5| 1.7| 6.7|10.6| 2.5|56.0|    |
  3206.      ---------------------------------------------------------
  3207.  
  3208.  
  3209.  
  3210. TSMorph.guide/File_Names
  3211.  
  3212.  
  3213. File naming
  3214. ***********
  3215.  
  3216. File names can include the frame number.
  3217.  
  3218. The format of the frame number in the file name is specified using the
  3219. following formats:
  3220.  
  3221.      %ld     : Number left justified e.g.  '1','2',..,'10',..,'123',..
  3222.      %3ld    : Number right justified e.g. '  1','  2',..,' 10',..,'123',..
  3223.      %03ld   : Number right justified e.g. '001','002',..,'010',..,'123',..
  3224.  
  3225. Where the number can be changed e.g.
  3226.  
  3227.      pic.%04ld   for Imagine 2.0 produced files
  3228.      pic%03ld    for Vista produced files
  3229.      name%ld     for files to run through mpeg
  3230.  
  3231.  
  3232.  
  3233. TSMorph.guide/Errors
  3234.  
  3235.  
  3236. Error Messages
  3237. **************
  3238.  
  3239. The following messages can be displayed in an Error Requester.
  3240.  
  3241.  
  3242.   Both Images must be the same size                 
  3243.   Unable to Open Grid Requester                         
  3244.   Both X Cells and Y Cells must be > 0               
  3245.   Out of memory for points                                  
  3246.   No ILBM.BMHD chunk                                   
  3247.   Failed to allocate raster                              
  3248.   No ILBM.BODY chunk                                   
  3249.   Not an ILBM                                          
  3250.   Clipboard open failed                                
  3251.   xxxx; File open failed                                
  3252.   Parsing error; no top chunk                         
  3253.   Not enough memory                                      
  3254.   Failure opening TSMorph Window                           
  3255.   Failure setting up screen                                
  3256.   Can not Open xxxx.library(n)                         
  3257.   Unable to Allocate FileRequest                       
  3258.   Unable to Create Window Message Port               
  3259.   Can not Open input.device                            
  3260.   Image smaller than points                           
  3261.   Images different sizes                                  
  3262.   Unable to Allocate Zoom raster                       
  3263.   Unable to SetMenuStrip                            
  3264.   Unable to OpenWindowTags                                
  3265.   Unable to AllocMem for Filename                      
  3266.   Unable to Allocate xxxx Gadget                           
  3267.   Unable to Allocate xxxx Image                           
  3268.   Failure loading Image 'xxxx'                           
  3269.   Unable to AllocIFF                                    
  3270.   Unable to AllocMem for ILBMInfo                        
  3271.   Unable to GetScreenDrawInfo                         
  3272.   Unable to LockPubScreen(xxxx)                           
  3273.   Invalid file format - Line 'xxxx'                       
  3274.   Images are too small                                  
  3275.   Point out of range - Line 'xxxx'                   
  3276.   Out of memory for points                               
  3277.   Invalid point link - Line 'xxxx'                         
  3278.   Error closing file 'xxxx'                              
  3279.   Error opening file 'xxxx'                             
  3280.   Error writing to 'xxxx'                                
  3281.   Point already linked to 16 points                    
  3282.   Point not linked                                       
  3283.   Cannot link point to itself                           
  3284.   Points already linked                               
  3285.   Cannot unlink point from itself                         
  3286.   Error no memory for new point                            
  3287.   Unable to Open xxxx.library(n)                        
  3288.   Error saving file 'xxxx'                            
  3289.   Error AllocVec for output                             
  3290.   Error Opening points file                               
  3291.   Error opening progress window                         
  3292.   Unable to allocate memory for bitmap                     
  3293.   Image must be 24 bit 'xxxx'                     
  3294.   Error loading 'xxxx'                              
  3295.   Size does not match image - Line 'xxxx'                
  3296.   Out of memory for points                                
  3297.   Must have at least 3 points                          
  3298.   Error sending ARexx message - 'xxxx'               
  3299.   Assuming version 1.0 file format                       
  3300.   Must have at least one frame                          
  3301.   Frames must all be the same size                     
  3302.   Failure - yyyy - loading 'xxxx'                         
  3303.   Error Saving Settings 'xxxx'                       
  3304.   Error Loading Settings 'xxxx'                      
  3305.   No opal.library                                     
  3306.   File does not exist 'xxxx'                          
  3307.   Error opening screen                                 
  3308.   Unable to get DrawInfo                             
  3309.   Unable to lock Workbench                           
  3310.   Invalid screen mode xxxx                           
  3311.   TSMorph is attempting to close this ...   
  3312.  
  3313.  
  3314.  
  3315. TSMorph.guide/Err-Size
  3316.  
  3317.  
  3318. Error - Both Images must be the same size
  3319. =========================================
  3320.  
  3321. This message should never be displayed. Images different sizes  should
  3322. be displayed instead.
  3323.  
  3324. Resolution - None required.
  3325.  
  3326.  
  3327.  
  3328. TSMorph.guide/Err-OpenGrid
  3329.  
  3330.  
  3331. Unable to Open Grid Requester
  3332. =============================
  3333.  
  3334. TSMorph is unable to open the Add Grid  requester. The normal reason
  3335. would be lack of memory.
  3336.  
  3337. Resolution - Free up some memory and retry.
  3338.  
  3339.  
  3340.  
  3341. TSMorph.guide/Err-Grid0
  3342.  
  3343.  
  3344. Error - Both X Cells and Y Cells must be > 0
  3345. ============================================
  3346.  
  3347. This message is displayed if the Add Grid  requester is used and either
  3348. the X Cells  or Y Cells  is set to 0. The minimum allowed value is 1.
  3349.  
  3350. Resolution - Input at least 1 in both gadgets, or cancel  the requester.
  3351.  
  3352.  
  3353.  
  3354. TSMorph.guide/Err-MemoryPoints
  3355.  
  3356.  
  3357. Error - Out of memory for points
  3358. ================================
  3359.  
  3360. This message is displayed after the Add Grid  requester has been used
  3361. and points and lines are being added to the images. Insufficient memory
  3362. is available.
  3363.  
  3364. Resolution - Since it is possible that some of the points have been
  3365. added to the images then you may wish to use the New Points  menu item
  3366. to delete all points. Then free up some memory and retry.
  3367.  
  3368.  
  3369.  
  3370. TSMorph.guide/Err-IFFBMHD
  3371.  
  3372.  
  3373. Error - No ILBM.BMHD chunk
  3374. ==========================
  3375.  
  3376. The Image being loaded has no BMHD chunk.
  3377.  
  3378. Resolution - Specify the name of a correct ILBM image.
  3379.  
  3380.  
  3381.  
  3382. TSMorph.guide/Err-IFFRaster
  3383.  
  3384.  
  3385. Error - Failed to allocate raster
  3386. =================================
  3387.  
  3388. There is insufficient memory to load the ILBM image.
  3389.  
  3390. Resolution - Free up some memory and retry.
  3391.  
  3392.  
  3393.  
  3394. TSMorph.guide/Err-IFFBODY
  3395.  
  3396.  
  3397. Error - No ILBM.BODY chunk
  3398. ==========================
  3399.  
  3400. The Image being loaded has no BODY chunk.
  3401.  
  3402. Resolution - Specify the name of a correct ILBM image.
  3403.  
  3404.  
  3405.  
  3406. TSMorph.guide/Err-IFFILBM
  3407.  
  3408.  
  3409. Error - Not an ILBM
  3410. ===================
  3411.  
  3412. The Image being loaded is not and ILBM file.
  3413.  
  3414. Resolution - Specify the name of a correct ILBM image.
  3415.  
  3416.  
  3417.  
  3418. TSMorph.guide/Err-IFFCLIP
  3419.  
  3420.  
  3421. Error - Clipboard open failed
  3422. =============================
  3423.  
  3424. The program is unable to open the specified clipboard.
  3425.  
  3426. Resolution - Retry with the correct clipboard number, or use a
  3427. different file name.
  3428.  
  3429.  
  3430.  
  3431. TSMorph.guide/Err-IFFFileS
  3432.  
  3433.  
  3434. Error - xxxx; File open failed
  3435. ==============================
  3436.  
  3437. File xxxx can not be successfully opened. The file does not exist (if
  3438. trying to read), is already in use, or the filename is invalid.
  3439.  
  3440. Resolution - Retry with a valid file name.
  3441.  
  3442.  
  3443.  
  3444. TSMorph.guide/Err-IFFTop
  3445.  
  3446.  
  3447. Error - Parsing error; no top chunk
  3448. ===================================
  3449.  
  3450. This is a technical error which should never occur.
  3451.  
  3452. Resolution - Unknown.
  3453.  
  3454.  
  3455.  
  3456. TSMorph.guide/Err-IFFMemory
  3457.  
  3458.  
  3459. Error - Not enough memory
  3460. =========================
  3461.  
  3462. There is insufficient memory to save or load the IFF ILBM file.
  3463.  
  3464. Resolution - Free up some memory and retry.
  3465.  
  3466.  
  3467.  
  3468. TSMorph.guide/Err-OpenTSMorph
  3469.  
  3470.  
  3471. Error - Failure opening TSMorph Window
  3472. ======================================
  3473.  
  3474. The Information Window  window could not be opened. There is probably
  3475. insufficient memory.
  3476.  
  3477. Resolution - Free up some memory and retry.
  3478.  
  3479.  
  3480.  
  3481. TSMorph.guide/Err-SetupScreen
  3482.  
  3483.  
  3484. Error - Failure setting up screen
  3485. =================================
  3486.  
  3487. The Information Window  window could not be opened. Either the
  3488. Public Screen  is not open or there is insufficient memory.
  3489.  
  3490. Resolution - Free up some memory and retry, or correct the PUBSCREEN 
  3491. parameter.
  3492.  
  3493.  
  3494.  
  3495. TSMorph.guide/Err-Library
  3496.  
  3497.  
  3498. Error - Can not Open xxxx.library(n)
  3499. ====================================
  3500.  
  3501. The library xxxx version number n could not be opened. See Requirements 
  3502. for a list of libraries required. It could just be a lack of memory.
  3503.  
  3504. Resolution - Ensure you are running at least version 2.04 of the
  3505. operating system, or free up some memory and retry.
  3506.  
  3507.  
  3508.  
  3509. TSMorph.guide/Err-FileReq
  3510.  
  3511.  
  3512. Error - Unable to Allocate FileRequest
  3513. ======================================
  3514.  
  3515. Insufficient memory is available.
  3516.  
  3517. Resolution - Free up some memory and retry.
  3518.  
  3519.  
  3520.  
  3521. TSMorph.guide/Err-WPort
  3522.  
  3523.  
  3524. Error - Unable to Create Window Message Port
  3525. ============================================
  3526.  
  3527. Insufficient memory is available.
  3528.  
  3529. Resolution - Free up some memory and retry.
  3530.  
  3531.  
  3532.  
  3533. TSMorph.guide/Err-IDevice
  3534.  
  3535.  
  3536. Error - Can not Open input.device
  3537. =================================
  3538.  
  3539. Insufficient memory is available.
  3540.  
  3541. Resolution - Free up some memory and retry.
  3542.  
  3543.  
  3544.  
  3545. TSMorph.guide/Err-ISmall
  3546.  
  3547.  
  3548. Error - Image smaller than points
  3549. =================================
  3550.  
  3551. The image trying to be loaded is smaller than the points already
  3552. defined.
  3553.  
  3554. Resolution - Load a larger image, or select the New  menu item and
  3555. restart.
  3556.  
  3557.  
  3558.  
  3559. TSMorph.guide/Err-IDifferent
  3560.  
  3561.  
  3562. Error - Images different sizes
  3563. ==============================
  3564.  
  3565. This can be displayed when opening the second image in TSMorph. Both
  3566. images must have the same horizontal and vertical resolutions. The image
  3567. depths can be different.
  3568.  
  3569. Resolution - Either use a different pair of images, or change the size
  3570. of one of the images using some image-processing program.
  3571.  
  3572.  
  3573.  
  3574. TSMorph.guide/Err-ZRaster
  3575.  
  3576.  
  3577. Error - Unable to Allocate Zoom raster
  3578. ======================================
  3579.  
  3580. Insufficient memory is available.
  3581.  
  3582. Resolution - Free up some memory and retry. If you still do not have
  3583. enough memory then rerun specifying ZOOM=OFF  as a parameter.
  3584.  
  3585.  
  3586.  
  3587. TSMorph.guide/Err-Menu
  3588.  
  3589.  
  3590. Error - Unable to SetMenuStrip
  3591. ==============================
  3592.  
  3593. Insufficient memory is available.
  3594.  
  3595. Resolution - Free up some memory and retry.
  3596.  
  3597.  
  3598.  
  3599. TSMorph.guide/Err-OpenWindow
  3600.  
  3601.  
  3602. Error - Unable to OpenWindowTags
  3603. ================================
  3604.  
  3605. Insufficient memory is available.
  3606.  
  3607. Resolution - Free up some memory and retry.
  3608.  
  3609.  
  3610.  
  3611. TSMorph.guide/Err-MemFile
  3612.  
  3613.  
  3614. Error - Unable to AllocMem for Filename
  3615. =======================================
  3616.  
  3617. Insufficient memory is available.
  3618.  
  3619. Resolution - Free up some memory and retry.
  3620.  
  3621.  
  3622.  
  3623. TSMorph.guide/Err-AllocGadget
  3624.  
  3625.  
  3626. Error - Unable to Allocate xxxx Gadget
  3627. ======================================
  3628.  
  3629. Insufficient memory is available.
  3630.  
  3631. Resolution - Free up some memory and retry.
  3632.  
  3633.  
  3634.  
  3635. TSMorph.guide/Err-AllocImage
  3636.  
  3637.  
  3638. Error - Unable to Allocate xxxx Image
  3639. =====================================
  3640.  
  3641. Insufficient memory is available.
  3642.  
  3643. Resolution - Free up some memory and retry.
  3644.  
  3645.  
  3646.  
  3647. TSMorph.guide/Err-LoadImage
  3648.  
  3649.  
  3650. Error - Failure loading Image 'xxxx'
  3651. ====================================
  3652.  
  3653. There was an error loading the image xxxx. Another error message should
  3654. previously have been displayed.
  3655.  
  3656. Resolution - See previous error message.
  3657.  
  3658.  
  3659.  
  3660. TSMorph.guide/Err-AllocIFF
  3661.  
  3662.  
  3663. Error - Unable to AllocIFF
  3664. ==========================
  3665.  
  3666. Insufficient memory is available.
  3667.  
  3668. Resolution - Free up some memory and retry.
  3669.  
  3670.  
  3671.  
  3672. TSMorph.guide/Err-AllocILBM
  3673.  
  3674.  
  3675. Error - Unable to AllocMem for ILBMInfo
  3676. =======================================
  3677.  
  3678. Insufficient memory is available.
  3679.  
  3680. Resolution - Free up some memory and retry.
  3681.  
  3682.  
  3683.  
  3684. TSMorph.guide/Err-GetDRI
  3685.  
  3686.  
  3687. Error - Unable to GetScreenDrawInfo
  3688. ===================================
  3689.  
  3690. Insufficient memory is available.
  3691.  
  3692. Resolution - Free up some memory and retry.
  3693.  
  3694.  
  3695.  
  3696. TSMorph.guide/Err-LockScreen
  3697.  
  3698.  
  3699. Error - Unable to LockPubScreen(xxxx)
  3700. =====================================
  3701.  
  3702. Either the Public Screen  is not open or there is insufficient memory.
  3703.  
  3704. Resolution - Free up some memory and retry, or correct the PUBSCREEN 
  3705. parameter.
  3706.  
  3707.  
  3708.  
  3709. TSMorph.guide/Err-FileFormat
  3710.  
  3711.  
  3712. Error - Invalid file format - Line 'xxxx'
  3713. =========================================
  3714.  
  3715. The points file being loaded is in an incorrect Format  or is not a
  3716. points file.
  3717.  
  3718. Resolution - Specify a correct points file or manually edit the file
  3719. and retry.
  3720.  
  3721.  
  3722.  
  3723. TSMorph.guide/Err-TooSmall
  3724.  
  3725.  
  3726. Error - Images are too small
  3727. ============================
  3728.  
  3729. The images specified in the input file are too small.
  3730.  
  3731. Resolution - Either edit the input file - See Format , or select the New 
  3732. menu item and retry.
  3733.  
  3734.  
  3735.  
  3736. TSMorph.guide/Err-Range
  3737.  
  3738.  
  3739. Error - Point out of range - Line 'xxxx'
  3740. ========================================
  3741.  
  3742. The point coordinates specified in the input file is larger than the
  3743. image size.
  3744.  
  3745. Resolution - Manually edit the input file - See Format  and retry.
  3746.  
  3747.  
  3748.  
  3749. TSMorph.guide/Err-MemPoints
  3750.  
  3751.  
  3752. Error - Out of memory for points
  3753. ================================
  3754.  
  3755. Insufficient memory is available.
  3756.  
  3757. Resolution - Free up some memory and retry after selecting either New 
  3758. or New Points  to delete existing points.
  3759.  
  3760.  
  3761.  
  3762. TSMorph.guide/Err-InvalidLink
  3763.  
  3764.  
  3765. Error - Invalid point link - Line 'xxxx'
  3766. ========================================
  3767.  
  3768. The points linking specified in the input file is invalid.
  3769.  
  3770. Resolution - Manually edit the input file - See Format  and retry.
  3771.  
  3772.  
  3773.  
  3774. TSMorph.guide/Err-CloseFile
  3775.  
  3776.  
  3777. Error - Error closing file 'xxxx'
  3778. =================================
  3779.  
  3780. The file xxxx could not be successfully closed. The disc may be full.
  3781.  
  3782. Resolution - If saving then save the file to a different disk or free up
  3783. some disk space and retry with another name. The original file may not
  3784. be accessible until after a reboot.
  3785.  
  3786.  
  3787.  
  3788. TSMorph.guide/Err-OpenFile
  3789.  
  3790.  
  3791. Error - Error opening file 'xxxx'
  3792. =================================
  3793.  
  3794. The file xxxx could not be opened. The file does not exist (when
  3795. reading), the name is invalid, the file is already in use, or the disk
  3796. is write protected.
  3797.  
  3798. Resolution - Use a different file name or allow the disk to be written
  3799. to.
  3800.  
  3801.  
  3802.  
  3803. TSMorph.guide/Err-WriteFile
  3804.  
  3805.  
  3806. Error - Error writing to 'xxxx'
  3807. ===============================
  3808.  
  3809. The file xxxx could not be successfully written to. The disc may be
  3810. full. The file has not been successfully saved.
  3811.  
  3812. Resolution - Save the file to a different disk or free up some disk
  3813. space and retry.
  3814.  
  3815.  
  3816.  
  3817. TSMorph.guide/Err-4Points
  3818.  
  3819.  
  3820. Error - Point already linked to 16 points
  3821. =========================================
  3822.  
  3823. Any point can only be linked  to up to 16 other points. Note: the links
  3824. are only for clarity and do not effect the rendering process.
  3825.  
  3826. Resolution - Unlink  the current point from some other point and retry.
  3827.  
  3828.  
  3829.  
  3830. TSMorph.guide/Err-NotLinked
  3831.  
  3832.  
  3833. Error - Point not linked
  3834. ========================
  3835.  
  3836. The points just selected are not currently linked  and cannot therefore
  3837. be unlinked.
  3838.  
  3839. Resolution - None required.
  3840.  
  3841.  
  3842.  
  3843. TSMorph.guide/Err-LinkSelf
  3844.  
  3845.  
  3846. Error - Cannot link point to itself
  3847. ===================================
  3848.  
  3849. A point can not be Linked  to itself.
  3850.  
  3851. Resolution - Select another point to link to.
  3852.  
  3853.  
  3854.  
  3855. TSMorph.guide/Err-Linked
  3856.  
  3857.  
  3858. Error - Points already linked
  3859. =============================
  3860.  
  3861. The points you are trying to link  are already linked.
  3862.  
  3863. Resolution - None required.
  3864.  
  3865.  
  3866.  
  3867. TSMorph.guide/Err-UnlinkSelf
  3868.  
  3869.  
  3870. Error - Cannot unlink point from itself
  3871. =======================================
  3872.  
  3873. A point can not be unlinked  from itself.
  3874.  
  3875. Resolution - Select another point to unlink from.
  3876.  
  3877.  
  3878.  
  3879. TSMorph.guide/Err-MemNewPoint
  3880.  
  3881.  
  3882. Error - Error no memory for new point
  3883. =====================================
  3884.  
  3885. There is no memory to add the new point.
  3886.  
  3887. Resolution - Free up some memory and retry.
  3888.  
  3889.  
  3890.  
  3891. TSMorph.guide/Err-LibraryR
  3892.  
  3893.  
  3894. Error - Unable to Open xxxx.library(n)
  3895. ======================================
  3896.  
  3897. The library xxxx version number n could not be opened. See Requirements 
  3898. for a list of libraries required. It could just be a lack of memory.
  3899.  
  3900. Resolution - Ensure you are running at least version 2.04 of the
  3901. operating system, or free up some memory and retry.
  3902.  
  3903.  
  3904.  
  3905. TSMorph.guide/Err-Saving
  3906.  
  3907.  
  3908. Error - Error saving file 'xxxx'
  3909. ================================
  3910.  
  3911. Some error occurred saving the IFF ILBM output file. Another error
  3912. requester may have previously appeared. Alternatively there could be a
  3913. lack of memory. This error is also displayed when trying to save DCTV
  3914. images in an invalid size.
  3915.  
  3916. Resolution - See the previous error message, or free up some memory and
  3917. retry.
  3918.  
  3919.  
  3920.  
  3921. TSMorph.guide/Err-AllocVec
  3922.  
  3923.  
  3924. Error - Error AllocVec for output
  3925. =================================
  3926.  
  3927. Insufficient memory is available.
  3928.  
  3929. Resolution - Free up some memory and retry.
  3930.  
  3931.  
  3932.  
  3933. TSMorph.guide/Err-OpenPoints
  3934.  
  3935.  
  3936. Error - Error Opening points file
  3937. =================================
  3938.  
  3939. The input file specified to TSMorph-render does not exist or is in an
  3940. invalid format.
  3941.  
  3942. Resolution - Either specify a valid input file, or manually edit the
  3943. points file.
  3944.  
  3945.  
  3946.  
  3947. TSMorph.guide/Err-Progress
  3948.  
  3949.  
  3950. Error - Error opening progress window
  3951. =====================================
  3952.  
  3953. Some error occurred opening the Progress  requester in TSMorph-render.
  3954. Probably a lack of memory, or the PUBSCREENR  parameter specifies a not
  3955. open public screen name.
  3956.  
  3957. Resolution - Free up some memory or correct the parameter and retry.
  3958.  
  3959.  
  3960.  
  3961. TSMorph.guide/Err-AllocPlanes
  3962.  
  3963.  
  3964. Error - Unable to allocate memory for bitmap
  3965. ============================================
  3966.  
  3967. Insufficient memory is available for some bitmap planes.
  3968.  
  3969. Resolution - Free up some memory and retry.
  3970.  
  3971.  
  3972.  
  3973. TSMorph.guide/Err-24
  3974.  
  3975.  
  3976. Error - Image must be 24 bit 'xxxx'
  3977. ===================================
  3978.  
  3979. The image xxxx being loaded by TSMorph-render is not a 24 bit image.
  3980. Only 24 bit ILBM images can be rendered.
  3981.  
  3982. This is an obsolete message which should not appear.
  3983.  
  3984. Resolution - Use TSMorph to specify a valid 24 bit ILBM image.
  3985.  
  3986.  
  3987.  
  3988. TSMorph.guide/Err-Load
  3989.  
  3990.  
  3991. Error - Error loading 'xxxx'
  3992. ============================
  3993.  
  3994. The image xxxx being loaded by TSMorph-render could not be loaded. A
  3995. previous error requester could have appeared. The file name could be
  3996. invalid.
  3997.  
  3998. Resolution - See the previous error message.
  3999.  
  4000.  
  4001.  
  4002. TSMorph.guide/Err-SizeMatch
  4003.  
  4004.  
  4005. Error - Size does not match image - Line 'xxxx'
  4006. ===============================================
  4007.  
  4008. The points file being loaded - See File Format  - has an image size
  4009. specified which does not match the image being loaded.
  4010.  
  4011. Resolution - Change the image size, manually edit the input file, or
  4012. respecify the image name using TSMorph.
  4013.  
  4014.  
  4015.  
  4016. TSMorph.guide/Err-MemPointsR
  4017.  
  4018.  
  4019. Error - Out of memory for points
  4020. ================================
  4021.  
  4022. Insufficient memory is available.
  4023.  
  4024. Resolution - Free up some memory and retry.
  4025.  
  4026.  
  4027.  
  4028. TSMorph.guide/Err-3Points
  4029.  
  4030.  
  4031. Error - Must have at least 3 points
  4032. ===================================
  4033.  
  4034. In order to correctly render an image at least 3 points must be defined.
  4035.  
  4036. Resolution - Use TSMorph to define at least 3 points - e.g. in 3 of the
  4037. corners.
  4038.  
  4039.  
  4040.  
  4041. TSMorph.guide/Err-ARexx
  4042.  
  4043.  
  4044. Error - Error sending ARexx message - 'xxxx'
  4045. ============================================
  4046.  
  4047. TSMorph-render or TSMorph has had a problem sending the ARexx  message.
  4048. ARexx may not be running, or the script may not exist or have errors.
  4049.  
  4050. Resolution - Ensure ARexx is running, check the scripts - See parameters
  4051. PRESCRIPT , POSTSCRIPT  and LOADSCRIPT , or PREVIEW  - exist and have TSM
  4052. as a suffix.
  4053.  
  4054. If the above is OK then use TCO and TS to interactively trace the
  4055. script.
  4056.  
  4057.  
  4058.  
  4059. TSMorph.guide/Err-OldFormat
  4060.  
  4061.  
  4062. Error - Assuming version 1.0 file format
  4063. ========================================
  4064.  
  4065. The current version of the File Format  has a header record. This error
  4066. is saying no header is present, it is assumed that the file is in an
  4067. old format.
  4068.  
  4069. Resolution - Select OK to continue. Load and Save in TSMorph to save in
  4070. the new format if required.
  4071.  
  4072.  
  4073.  
  4074. TSMorph.guide/Err-OneFrame
  4075.  
  4076.  
  4077. Error - Must have at least one frame
  4078. ====================================
  4079.  
  4080. This is displayed when trying to edit points on an Animated Morph/Warp
  4081. when the number of frames is 0.
  4082.  
  4083. Resolution - Set the number of frames  to at least 1.
  4084.  
  4085.  
  4086.  
  4087. TSMorph.guide/Err-AllSize
  4088.  
  4089.  
  4090. Error - Frames must all be the same size
  4091. ========================================
  4092.  
  4093. This is displayed when trying to change to a different frame. The size
  4094. of all input images must be the same.
  4095.  
  4096. Resolution - Ensure all input images are the same size.
  4097.  
  4098.  
  4099.  
  4100. TSMorph.guide/Err-OpalVision
  4101.  
  4102.  
  4103. Error - Failure - yyyy - loading 'xxxx'
  4104. =======================================
  4105.  
  4106. opal.library had a problem loading image xxxx.
  4107.  
  4108. Resolution - yyyy should describe the problem.
  4109.  
  4110.  
  4111.  
  4112. TSMorph.guide/Err-SaveS
  4113.  
  4114.  
  4115. Error - Error Saving Settings 'xxxx'
  4116. ====================================
  4117.  
  4118. This message is displayed when TSMorph has been unable to save settings 
  4119. in the named file. If KEEPSETTINGS  is set to YES then settings are
  4120. saved in ENV:TSMorph/TSMorph.prefs when the program is quit.
  4121.  
  4122. Resolution - Supply a correct filename, set KEEPSETTINGS to NO, or
  4123. create the directory ENV:TSMorph
  4124.  
  4125.  
  4126.  
  4127. TSMorph.guide/Err-LoadS
  4128.  
  4129.  
  4130. Error - Error Loading Settings 'xxxx'
  4131. =====================================
  4132.  
  4133. TSMorph has had a problem loading the specified file. The file probably
  4134. does not exist.
  4135.  
  4136. Resolution - Specify a correct file name
  4137.  
  4138.  
  4139.  
  4140. TSMorph.guide/Err-NoOpal
  4141.  
  4142.  
  4143. Error - No opal.library
  4144. =======================
  4145.  
  4146. TSMorph or TSMorph-render is trying to load an image using opal.library
  4147. but it could not be opened.
  4148.  
  4149. Resolution - For TSMorph - If you do not have opal.library do not
  4150. specify OPENMODE=OPAL. If you are not specifying this then the image
  4151. you are trying to load must be in a format which TSMorph does not
  4152. understand (this may be some unsupported JPEG variant).
  4153.  
  4154. For TSMorph-render - This is trying to load some unsupported image
  4155. format.
  4156.  
  4157.  
  4158.  
  4159. TSMorph.guide/Err-NoFile
  4160.  
  4161.  
  4162. Error - File does not exist 'xxxx'
  4163. ==================================
  4164.  
  4165. TSMorph is trying to load an image from a file which does not exist or
  4166. is inaccessible.
  4167.  
  4168. Resolution - Specify a valid file name.
  4169.  
  4170.  
  4171.  
  4172. TSMorph.guide/Err-OScreen
  4173.  
  4174.  
  4175. Error - Error opening screen
  4176. ============================
  4177.  
  4178. TSMorph has been unable to open the requested screen. This could be
  4179. because the CUSTOMDEPTH  is too great for the CUSTOMMODE , there is not
  4180. enough memory, or some other related reason.
  4181.  
  4182. Resolution - Check you have enough memory, make sure the screen depth
  4183. is OK for the screen mode.
  4184.  
  4185.  
  4186.  
  4187. TSMorph.guide/Err-DrawI
  4188.  
  4189.  
  4190. Error - Unable to get DrawInfo
  4191. ==============================
  4192.  
  4193. TSMorph has been unable to obtain some information from the Workbench,
  4194. probably due to lack of memory.
  4195.  
  4196. Resolution - Free up some memory and retry.
  4197.  
  4198.  
  4199.  
  4200. TSMorph.guide/Err-LockW
  4201.  
  4202.  
  4203. Error - Unable to lock Workbench
  4204. ================================
  4205.  
  4206. TSMorph has been unable to obtain some information from the Workbench,
  4207. probably due to lack of memory.
  4208.  
  4209. Resolution - Free up some memory and retry.
  4210.  
  4211.  
  4212.  
  4213. TSMorph.guide/Err-SMode
  4214.  
  4215.  
  4216. Invalid screen mode xxxx
  4217. ========================
  4218.  
  4219. The screen mode specified by CUSTOMMODE  is not a valid screen mode.
  4220.  
  4221. Resolution - Check the screen mode against the list show in the
  4222. preferences screen mode requester.
  4223.  
  4224.  
  4225.  
  4226. TSMorph.guide/Err-CScreen
  4227.  
  4228.  
  4229. TSMorph is attempting to close this ...
  4230. =======================================
  4231.  
  4232. TSMorph is trying to close the Public Screen  that it opened but is
  4233. unable to as there are locks (probably open windows) on the screen.
  4234.  
  4235. Resolution - Close all other open windows on the screen and retry.
  4236.  
  4237.  
  4238.  
  4239. TSMorph.guide/Bugs
  4240.  
  4241.  
  4242. Known (and unknown errors)
  4243. **************************
  4244.  
  4245.    * Known Problems
  4246.  
  4247.         * Unsaved project does not check that gadgets really have been
  4248.           edited.
  4249.  
  4250.         * This guide sometimes has very long lines. Also bold items
  4251.           following * are followed by too many spaces.  This appears to
  4252.           be due to a problem with MakeInfo, menus and lists.
  4253.  
  4254.         * This guide does not look correct when using
  4255.           amigaguide.library versions before 39. This will not be fixed.
  4256.  
  4257.         * Fails to do anything if run on less than 2.04 (could display
  4258.           a message). This is unlikely to be fixed.
  4259.  
  4260.         * Progress gadgets do not look to good using 2.04. They do look
  4261.           OK when using 3.0+. This will not be fixed.
  4262.  
  4263.         * 24 bit ILBMs are loaded into Chip memory. If you do not have
  4264.           enough, then convert the input images to PPM or JPEG first.
  4265.           (Thanks to Jamie Cope).
  4266.  
  4267.    * Unknown Problems?
  4268.  
  4269.         * Image validation requires tidying up - especially with anim
  4270.           morphs/warps.
  4271.  
  4272.         *     TSMorph and TSMorph-render may not release all memory.
  4273.  
  4274.         *     TSMorph-prefs has not been well tested.
  4275.  
  4276.         *     TSMorph may open zoomed large windows with corruption.
  4277.  
  4278.         * Width and Height in the parameter file may not be correctly
  4279.           set and require manual editing.
  4280.  
  4281. Please report any other bugs by EMail to mark@topic.demon.co.uk or
  4282. mpaddock@cix.compulink.co.uk.
  4283.  
  4284.  
  4285.  
  4286. TSMorph.guide/Hard-Software
  4287.  
  4288.  
  4289. Hardware and Software used in development
  4290. *****************************************
  4291.  
  4292.    * HSPascal            Editor.
  4293.  
  4294.    * SAS C               Code.
  4295.  
  4296.    * GadToolsBox         Info, Add Grid and Progress Windows.
  4297.      GadToolsBox is © Copyright 1991,92 Jaba Development.
  4298.  
  4299.    * DPaint              Control Window gadgets/Pointers.
  4300.  
  4301.    * Workbench 2.04      GUI.
  4302.  
  4303.    * MakeInfo            Documentation.
  4304.  
  4305.    * Iff2Src             Control Window gadgets. Iff2Src is © J
  4306.      Tyberghein.
  4307.  
  4308.    * ILBMtoC             Pointers.
  4309.  
  4310.    * IconEdit            Pointers.
  4311.  
  4312.    * NewIff              Various IFF routines.
  4313.  
  4314.    * ReqTools            For nicer requesters. ReqTools is © 1991/1992
  4315.      Nico François
  4316.  
  4317.    * OpalVision          For opal.library for easy file loading and
  4318.      saving. OpalVision is a trademark of Opal Technology Pty Ltd.
  4319.  
  4320.    * DCTV                For dctv.library for saving and loading DCTV
  4321.      images. DCTV is © 1991,1992 Digital Creations, Inc.
  4322.  
  4323.    * IJG JPEG software   For the PPM, TARGA, GIF and JPEG file loading
  4324.      code.
  4325.  
  4326.    * EGS                 For the EGS interface.
  4327.  
  4328.    * AG2TXT              For the .doc file. AG2TXT is Copyright (c)
  4329.      1993 Jason R. Hulance.
  4330.  
  4331.    * Fenster             To capture the windows
  4332.  
  4333.    * MKANIM              To generate Animations. MKANIM is Copyright ©
  4334.      1993 by John Bickers.
  4335.  
  4336.    * Viewtek             To display Animations. Viewtek is © 1992
  4337.      Thomas Krehbiel.
  4338.  
  4339.    * Commodore Amiga 2000 with 1MB chip ram,
  4340.  
  4341.    * Commodore 1960 monitor,
  4342.  
  4343.    * GVP SCSI hard card with 52MB Quantum disc,
  4344.  
  4345.    * RCS Fusion Forty accelerator with 8MB fast ram.
  4346.  
  4347.  
  4348.  
  4349. TSMorph.guide/History
  4350.  
  4351.  
  4352. Version History (since 2.0)
  4353. ***************************
  4354.  
  4355.    * Version 3.0
  4356.  
  4357.         * Recompiled using SAS/C 6.51.
  4358.  
  4359.         * Added 68040 version.
  4360.  
  4361.         * Now correctly handles AGA palettes.
  4362.  
  4363.         * Installer now included. (Thanks to Perry Horner).
  4364.  
  4365.         * Fixed a problem with the EGS pointer (Thanks to Darren
  4366.           Eveland).
  4367.  
  4368.    * Version 2.5
  4369.  
  4370.         * Major Enhancements
  4371.  
  4372.              * Added EGS support to TSMorph  and TSMorph-render.
  4373.  
  4374.              * Added INTEGER  parameter to TSMorph-render. This should
  4375.                make the program run faster, but the output will not be
  4376.                as good. The Icon supplied for the non FPU version has
  4377.                INTEGER=YES set by default, the default preview  script
  4378.                also sets this.
  4379.  
  4380.              * Added MODEs  4 to 31. This changes the Settings  menu.
  4381.  
  4382.              * Added Triangulate  menu item to convert point links to
  4383.                triangles. Points can now be linked to up to 16 other
  4384.                points.
  4385.  
  4386.              * Added a short tutorial - See
  4387.                Tutorial/Tutorial.readme.
  4388.  
  4389.              * Added documentation in plain text format - See
  4390.                TSMorph.doc. (Thanks to Perry
  4391.                Horner).
  4392.  
  4393.              * Added documentation in .html format - Mosaic is required
  4394.                to view this.
  4395.  
  4396.         * Minor Enhancments
  4397.  
  4398.              * Edited the graphics in this guide. It will only look
  4399.                correct under the OS3.0+ version of AmigaGuide.library.
  4400.  
  4401.              * When trying to close the Public Screen  TSMorph will
  4402.                display an error  if any other windows are open.
  4403.  
  4404.              * Horizontal  and Vertical  gadgets are now correct on 2
  4405.                colour screens.
  4406.  
  4407.              * Added REQTOOLS parameter to TSMorph  and TSMorph-render.
  4408.  
  4409.              *     TSMorph-render now uses nofrag.library for memory
  4410.                allocation if available.
  4411.  
  4412.              * Added new prescript  example script to render all frames.
  4413.  
  4414.              * Added new Hints & Tips  section.
  4415.  
  4416.              * Sped up the remapping of normal ILBM images.
  4417.  
  4418.              * Install script now determines 68020/881 correctly itself.
  4419.  
  4420.              * Added some new ARexx  scripts to generate animations.
  4421.  
  4422.         * Bug Fixes
  4423.  
  4424.              * Fixed a very silly bug with the DEPTH  parameter. It was
  4425.                always read as at least 20. This should speed up
  4426.                rendering.
  4427.  
  4428.              * TSMorph-prefs  and TSMorph  set ANTIALIAS  and HELP 
  4429.                correctly when Reset to Defaults.
  4430.  
  4431.              * Some fixes to the default PREVIEW  script. (Thanks to
  4432.                Stefan Haubenthal).
  4433.  
  4434.              * TSMorph-prefs  now correctly sets the Render mode.
  4435.  
  4436.              * Output images should not have garbage on the right hand
  4437.                side.
  4438.  
  4439.              * Lots of minor code and docs changes.
  4440.  
  4441.    * Version 2.4
  4442.  
  4443.         * Fixed bug where if 1st image for a Morph was loaded to
  4444.           convert the first frame then the second image was never
  4445.           loaded.
  4446.  
  4447.    * Version 2.3
  4448.  
  4449.         * Enhancements
  4450.  
  4451.              * Keyboard  shortcuts added to Edit  windows to change
  4452.                Edit Mode  (this prevents any screen flicker when
  4453.                CHANGEPALLETE  is set to YES).
  4454.  
  4455.         * Bug Fixes
  4456.  
  4457.              * Sensible message is displayed if opal.library is not
  4458.                present and an input image does not exist in
  4459.                TSMorph-render.
  4460.  
  4461.              *     TSMorph-render no longer attempts to load
  4462.                unnecessary images and point files for the first and
  4463.                last frames.
  4464.  
  4465.              * PREVIEW  can now be longer than the default value without
  4466.                causing public screen name problems.
  4467.  
  4468.              * TSMorph-prefs  no longer resets preferences to defaults
  4469.                if Open...  is cancelled.
  4470.  
  4471.              * Zoom?  menu item now works on the Info  window.
  4472.  
  4473.              * No longer opens project SETTINGS=  settings file twice.
  4474.  
  4475.              * Title of file requester to Open Project  is now Load
  4476.                Project not Load File.
  4477.  
  4478.              * Major source code clean up.
  4479.  
  4480.              * Source code is now available. Distribution is under GNU
  4481.                General Public Licence.  See distribution.
  4482.  
  4483.    * Version 2.2
  4484.  
  4485.         * Major Enhancements
  4486.  
  4487.              * Added Anti-Alias  capability to TSMorph-render.
  4488.  
  4489.              * Added ability to TSMorph and TSMorph-render to load a
  4490.                large variety of image formats (JPEG, ILBM (including 24
  4491.                bit, EHB, HAM6, HAM8 and DCTV with dctv.library), TARGA,
  4492.                GIF and PPM). See OPENMODE  and LOADSCRIPT.
  4493.  
  4494.              * Added a lot more save formats  (grey 16, grey 256, HAM 6,
  4495.                HAM 8 and DCTV3 and DCTV4 [with dctv.library]).
  4496.  
  4497.              * Added continuous help  option, and Help Text  gadget to
  4498.                TSMorph.
  4499.  
  4500.              * Added the Preview  option to preview render an image. See
  4501.                Preview... , Preview...  and PREVIEW.
  4502.  
  4503.              * Added the ability to open custom  screens.
  4504.  
  4505.              * Can now save the first and last images - see Prescript.
  4506.  
  4507.              * Added preferences editor TSMorph-prefs.
  4508.  
  4509.         * Minor Enhancements
  4510.  
  4511.              * Loading Image requester is displayed. See OPENMODE.
  4512.  
  4513.              * 24 File 1  and 24 File 2  gadgets can now be left blank to
  4514.                use the File One  and File Two  names.
  4515.  
  4516.              * MakeInfo 1.55 used. This doc now has more formatting.
  4517.  
  4518.              * Progress  requester now shows a list view of messages.
  4519.  
  4520.         * Bug Fixes
  4521.  
  4522.              * Image remapping should be more correct.
  4523.  
  4524.              * Edit/Mode  sub-menu has a capital E.
  4525.  
  4526.              * Should no longer leave the Screen with the incorrect
  4527.                palette  when TSMorph is quit.
  4528.  
  4529.              * Fixed a nasty memory corruption bug with DX  and DY.
  4530.  
  4531.              * Control Window gadgets  now look more correct on screens
  4532.                with more than 4 colours.
  4533.  
  4534.              * Fixed a bug where parameters  were automatically reset
  4535.                when opening a project.
  4536.  
  4537.              * Open Points...  no longer resets Morph parameters.
  4538.  
  4539.              * Load Settings...  now works.
  4540.  
  4541.              * DEPTH  parameter can now be greater than the number of
  4542.                points without memory corruption.
  4543.  
  4544.              *     TSMorph window is correctly disabled when saving
  4545.                after Unsaved Project  requester is displayed.
  4546.  
  4547.              * Uses less memory for Zoom  raster.
  4548.  
  4549.              *     TSMorph opens amigaguide window on screen specified
  4550.                by PUBSCREEN.
  4551.  
  4552.              * String requesters will now accept empty strings.
  4553.  
  4554.    * Version 2.0a
  4555.  
  4556.         * Minor update to the File Format  description. (Includes Anim
  4557.           Morphs and Warps).
  4558.  
  4559.         *     ENV/TSMorph/def_points now has Stack set to 8192.
  4560.           (Prevents crashes when using opal.library).
  4561.  
  4562.         * Render Public Screen  menu item is disabled if
  4563.           reqtools.library is not available. (Previously crashed if
  4564.           selected).
  4565.  
  4566.         * Only relevant OPENMODE  is ALWAYS if opal.library is not
  4567.           available (Thanks to spark@cix).
  4568.  
  4569.         * Screen is automatically brought to the front when the first
  4570.           window opens.
  4571.  
  4572.  
  4573.  
  4574. TSMorph.guide/Hints
  4575.  
  4576.  
  4577. Hints & Tips
  4578. ************
  4579.  
  4580. This section supplies some hopefully useful information which may not
  4581. be immediately apparent elsewhere.
  4582.  
  4583. Speed?
  4584.  
  4585. If you do not have an FPU then set the INTEGER parameter to YES.  Even
  4586. if you do have an FPU this may still make things run faster.
  4587.  
  4588. If it still slow then try changing DX and DY to 1 (or more).
  4589.  
  4590. If you have lots of memory then setting the precalculate part of MODE
  4591. (16) should help.
  4592.  
  4593. What MODE?
  4594.  
  4595. This depends on the type of Morph.
  4596.  
  4597. If you are, say, rotating some text on a background, then it is
  4598. probably best to set the stationary part (1). You would NOT want to set
  4599. the precalculate once part (16).
  4600.  
  4601. If you are morphing, say, two faces where the points do not move much
  4602. between the first and last image then it may be best to set the
  4603. precalculate part (16) (provided you have enough free memory). Setting
  4604. the Delaunay part (8) may also be a good idea.
  4605.  
  4606. Setting search (2) is probably not a good idea.
  4607.  
  4608. Not enough memory for TSMorph
  4609.  
  4610. If you run out of Chip memory when trying to load large images then try
  4611. setting ZOOM to OFF.
  4612.  
  4613. HAM output has fringing
  4614.  
  4615. A very simple algorithm is used for generating HAM output. If the
  4616. output is not acceptable then the best idea is to output some other
  4617. format (ILBM24 or PPM) and then run a proper image conversion program
  4618. on the output (possibly as part of the Postscript script).
  4619.  
  4620.  
  4621.  
  4622. TSMorph.guide/Distribution
  4623.  
  4624.  
  4625. Copyright and distribution requirements
  4626. ***************************************
  4627.  
  4628.       TSMorph - Amiga Morphing program
  4629.       Copyright (C) © 1993/94 Topicsave Limited
  4630.      
  4631.       This program is free software; you can redistribute it and/or modify
  4632.       it under the terms of the GNU General Public License as published by
  4633.       the Free Software Foundation; either version 2 of the License, or
  4634.       any later version.
  4635.      
  4636.       This program is distributed in the hope that it will be useful,
  4637.       but WITHOUT ANY WARRANTY; without even the implied warranty of
  4638.       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  4639.       GNU General Public License for more details.
  4640.      
  4641.       You should have received a copy of the GNU General Public License
  4642.       along with this program; if not, write to the Free Software
  4643.       Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  4644.      
  4645.       mark@topic.demon.co.uk
  4646.       mpaddock@cix.compulink.co.uk
  4647.  
  4648. TSMORPH IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE
  4649. MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY OR RESPONSIBILITY IS
  4650. ASSUMED.
  4651.  
  4652. TSMorph is ©1993/94 Topicsave Limited.
  4653.  
  4654. Please send any criticisms, bugs, etc. by EMail to
  4655. mark@topic.demon.co.uk or mpaddock@cix.compulink.co.uk.
  4656.  
  4657.          This software is based in part on the work of the Independent JPEG Group.
  4658.      
  4659.          The Graphics Interchange Format(c) is the Copyright property of
  4660.          CompuServe Incorporated.  GIF(sm) is a Service Mark property of
  4661.          CompuServe Incorporated.
  4662.  
  4663.          The Delaunay code was written by Dave Watson and uses the algorithm described in -
  4664.          Watson, D.F., 1981, Computing the n-dimensional Delaunay tessellation with
  4665.          application to Voronoi polytopes: The Computer J., 24(2), p. 167-172.
  4666.  
  4667.          Installer and Installer project icon
  4668.          (c) Copyright 1991-93 Commodore-Amiga, Inc.  All Rights Reserved.
  4669.          Reproduced and distributed under license from Commodore.
  4670.      
  4671.          INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  4672.          NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  4673.          OR RESPONSIBILITY IS ASSUMED.
  4674.  
  4675.  
  4676.  
  4677. TSMorph.guide/TSMorph-prefs
  4678.  
  4679.  
  4680. Preferences editor
  4681. ******************
  4682.  
  4683. TSMorph-prefs is a standard preferences editor.
  4684.  
  4685. When loaded it loads the current settings  from
  4686. ENV:TSMorph/TSMorph.prefs.  It then displays a window showing all
  4687. the preferences.
  4688.  
  4689. Help displays context sensitive help using amigaguide if available.
  4690.  
  4691.  
  4692.   Gadgets           Gadgets displayed in the Preferences Window
  4693.   Menus             Menus available in the Preferences Window
  4694.  
  4695.  
  4696.  
  4697. TSMorph.guide/TSMP-gad
  4698.  
  4699.  
  4700. TSMorph-prefs Gadgets
  4701. =====================
  4702.  
  4703.  
  4704.      -----------------------------------------------------------
  4705.      |. | TSMorph Preferences                            |  |  |
  4706.      |---------------------------------------------------------|
  4707.      |  Custom Screen         Render                TSMorph    |
  4708.      | NONE---------|   DX |--- 0 DY |--- 0     Zoom   YES     |
  4709.      | PAL:Low Res--|          Mode          Palette   YES     |
  4710.      | PAL:High Res-|   Save Format --|- 75     ModeIFCOLOURS  |
  4711.      | Depth --|---  4  AAx  Intx  Dep-|- 5    Prefsx   Helpx  |
  4712.      |                                                         |
  4713.      |            ARexx Script                Public Screen    |
  4714.      | Preview ...................   TSMorph ................  |
  4715.      |    Load ...................    Render ................  |
  4716.      |     Pre ...................              Icon           |
  4717.      |    Post ...................  Projectx  Prefsx  Renderx  |
  4718.      |                                                         |
  4719.      | Save                      Use                   Cancel  |
  4720.      -----------------------------------------------------------
  4721.  
  4722.  
  4723. System gadgets
  4724.   Close                         Close gadget
  4725.   Zoom                          Zoom gadget
  4726.   Depth gadget                  Depth gadget
  4727.  
  4728.  
  4729. Custom Screen
  4730.   Screen mode                   Custom screen mode
  4731.   Depth                         Custom screen depth
  4732.  
  4733.  
  4734. Render
  4735.   DX                            Render X skip
  4736.   DY                            Render Y skip
  4737.   Mode                          Render mode
  4738.   Save Format                   Render image format
  4739.   Quality                       JPEG Quality
  4740.   AA                            AntiAlias images
  4741.   Int                           Use Integer maths
  4742.   Dep                           Rendering depth
  4743.  
  4744.  
  4745. TSMorph
  4746.   Zoom                          Zoom images
  4747.   Palette                       Change palette
  4748.   Mode                          Open mode
  4749.   Prefs                         Keep preferences
  4750.   Help                          Continuous help
  4751.  
  4752.  
  4753. ARexx Script
  4754.   Preview                       Preview script
  4755.   Load                          Load image script
  4756.   Pre                           Pre render script
  4757.   Post                          Post render script
  4758.  
  4759.  
  4760. Public Screen
  4761.   TSMorph                       TSMorph public screen
  4762.   Render                        Render public screen
  4763.  
  4764.  
  4765. Icon
  4766.   Project                       Project Icons
  4767.   Prefs                         Preferences Icons
  4768.   Render                        Render Icons
  4769.  
  4770.  
  4771. Exit gadgets
  4772.   Save                          Save preferences
  4773.   Use                           Use preferences
  4774.   Cancel                        Cancel
  4775.  
  4776.  
  4777.  
  4778. TSMorph.guide/TSMP-Close
  4779.  
  4780.  
  4781. TSMorph-prefs Close gadget
  4782. --------------------------
  4783.  
  4784. This closes the window and discards any changes.
  4785.  
  4786.  
  4787.  
  4788. TSMorph.guide/TSMP-Zoom
  4789.  
  4790.  
  4791. TSMorph-prefs Zoom gadget
  4792. -------------------------
  4793.  
  4794. This is a standard zoom gadget and zooms the window to/from a title bar.
  4795.  
  4796.  
  4797.  
  4798. TSMorph.guide/TSMP-Depth
  4799.  
  4800.  
  4801. TSMorph-prefs Depth gadget
  4802. --------------------------
  4803.  
  4804. This is a standard depth gadget.
  4805.  
  4806.  
  4807.  
  4808. TSMorph.guide/TSMP-Save
  4809.  
  4810.  
  4811. TSMorph-prefs Save gadget
  4812. -------------------------
  4813.  
  4814. This save the settings  in ENV:TSMorph/TSMorph.prefs and
  4815. ENVARC:TSMorph/TSMorph.prefs.
  4816.  
  4817. Any changes are not picked up until TSMorph or TSMorph-render is
  4818. reloaded.
  4819.  
  4820.  
  4821.  
  4822. TSMorph.guide/TSMP-Use
  4823.  
  4824.  
  4825. TSMorph-prefs Use gadget
  4826. ------------------------
  4827.  
  4828. This save the settings  in ENV:TSMorph/TSMorph.prefs.
  4829.  
  4830. Any changes are not picked up until TSMorph or TSMorph-render is
  4831. reloaded.
  4832.  
  4833.  
  4834.  
  4835. TSMorph.guide/TSMP-Cancel
  4836.  
  4837.  
  4838. TSMorph-prefs Cancel gadget
  4839. ---------------------------
  4840.  
  4841. This closes the window and discards any changes.
  4842.  
  4843.  
  4844.  
  4845. TSMorph.guide/TSMP-men
  4846.  
  4847.  
  4848. TSMorph-prefs Menus
  4849. ===================
  4850.  
  4851. The following menus are available on the TSMorph-prefs Window:
  4852.  
  4853.  
  4854.   Project                     Project menu
  4855.  
  4856.   Edit                        Edit menu
  4857.  
  4858.   Settings                    Settings menu
  4859.  
  4860.  
  4861.  
  4862. TSMorph.guide/TSMP-men-Project
  4863.  
  4864.  
  4865. TSMorph-prefs Project menu
  4866. --------------------------
  4867.  
  4868. This menu contains the following items with their associated Amiga
  4869. short-cuts in the TSMorph-prefs Window:
  4870.  
  4871.  
  4872.   Open...     O                    Open a preferences file
  4873.   Save As...  S                    Save a preferences file
  4874.  
  4875.   Quit        Q                    Quit
  4876.  
  4877.  
  4878.  
  4879. TSMorph.guide/TSMP-men-P-Open
  4880.  
  4881.  
  4882. TSMorph-prefs Project/Open... menu item
  4883. .......................................
  4884.  
  4885. This displays a file requester to load the settings. The default name
  4886. is TSMorph.prefs in the current directory.
  4887.  
  4888.  
  4889.  
  4890. TSMorph.guide/TSMP-men-P-SaveAs
  4891.  
  4892.  
  4893. TSMorph-prefs Project/Save As... menu item
  4894. ..........................................
  4895.  
  4896. This displays a file requester to save the settings. The default name
  4897. is TSMorph.prefs in the current directory.
  4898.  
  4899.  
  4900.  
  4901. TSMorph.guide/TSMP-men-P-Quit
  4902.  
  4903.  
  4904. TSMorph-prefs Project/Quit menu item
  4905. ....................................
  4906.  
  4907. This closes the window and discards any changes.
  4908.  
  4909.  
  4910.  
  4911. TSMorph.guide/TSMP-men-Edit
  4912.  
  4913.  
  4914. TSMorph-prefs Edit menu
  4915. -----------------------
  4916.  
  4917. This menu contains the following items with their associated Amiga
  4918. short-cuts in the TSMorph-prefs Window:
  4919.  
  4920.  
  4921.   Reset To Defaults  D                     Reset preferences to defaults
  4922.   Last Saved         L                     Load preferences from ENVARC:
  4923.   Restore            R                     Load preferences from ENV:
  4924.  
  4925.  
  4926.  
  4927. TSMorph.guide/TSMP-men-E-ResetD
  4928.  
  4929.  
  4930. TSMorph-prefs Edit/Reset To Defaults menu item
  4931. ..............................................
  4932.  
  4933. This resets the settings  to their default values.
  4934.  
  4935.  
  4936.  
  4937. TSMorph.guide/TSMP-men-E-LastS
  4938.  
  4939.  
  4940. TSMorph-prefs Edit/Last Saved menu item
  4941. .......................................
  4942.  
  4943. This loads the settings  from ENVARC:TSMorph/TSMorph.prefs.
  4944.  
  4945.  
  4946.  
  4947. TSMorph.guide/TSMP-men-E-Restore
  4948.  
  4949.  
  4950. TSMorph-prefs Edit/Restore menu item
  4951. ....................................
  4952.  
  4953. This loads the settings  from ENV:TSMorph/TSMorph.prefs.
  4954.  
  4955.  
  4956.  
  4957. TSMorph.guide/TSMP-men-Settings
  4958.  
  4959.  
  4960. TSMorph-prefs Settings menu
  4961. ---------------------------
  4962.  
  4963. This menu contains the following items with their associated Amiga
  4964. short-cuts in the TSMorph-prefs Window:
  4965.  
  4966.  
  4967.   Create Icons?  I                   Create preference Icons
  4968.  
  4969.  
  4970.  
  4971. TSMorph.guide/TSMP-men-S-Icons
  4972.  
  4973.  
  4974. TSMorph-prefs Settings/Create Icons? menu item
  4975. ..............................................
  4976.  
  4977. This item toggles if Icons are to be saved with Settings  files. If it is
  4978. selected then an Icon will be saved. The icon will come from
  4979. ENV:TSMorph/def_prefs if this exists, secondly from ENV:SYS/def_prefs,
  4980. otherwise the default project Icon is used.
  4981.  
  4982. This menu item is similar to but can have a different value to the
  4983. CREATEICONSP  parameter.
  4984.  
  4985.  
  4986.  
  4987. TSMorph.guide/Index
  4988.  
  4989.  
  4990. Index
  4991. *****
  4992.  
  4993.  
  4994.  
  4995.  
  4996.   24 File 1 gadget                       I-gad-24_File_1
  4997.   24 File 2 gadget                       I-gad-24_File_2
  4998.   About                                  Req-About
  4999.   About... menu item                     CI-men-P-About
  5000.   About... menu item                     I-men-P-About
  5001.   Add                                    EMode-Add
  5002.   Add Grid                               Req-Add_Grid
  5003.   Add Grid... menu item                  CI-men-E-Grid
  5004.   Algorithms                             Algorithms
  5005.   ANTIALIAS=                             Par-TSMorph-render
  5006.   ARexx                                  AR
  5007.   Benchmarks                             Benchmarks
  5008.   Bugs                                   Bugs
  5009.   Cancel gadget                          Req-Add_Grid-gad-Cancel
  5010.   Cancel gadget                          TSMP-Cancel
  5011.   CHANGEPALETTE=                         Par-TSMorph
  5012.   Close gadget                           Con-gad-Close
  5013.   Close gadget                           Req-Add_Grid-gad-Close
  5014.   Close gadget                           TSMP-Close
  5015.   Close gadget                           E-gad-Close
  5016.   Close gadget                           I-gad-Close
  5017.   Control gadgets                        Con-gad
  5018.   Control keyboard controls              Con-Key
  5019.   Control menus                          CI-men
  5020.   Control Window                         Con
  5021.   Copyright                              Distribution
  5022.   Create Icons? menu item                TSMP-men-S-Icons
  5023.   CREATEICONS=                           Par-TSMorph
  5024.   CREATEICONSR=                          Par-TSMorph
  5025.   CREATEICONSR=                          Par-TSMorph-render
  5026.   Del                                    EMode-Delete
  5027.   Delete                                 EMode-Delete
  5028.   Delete... menu item                    I-men-P-Delete
  5029.   Depth gadget                           I-gad-Depth
  5030.   Depth gadget                           TSMP-Depth
  5031.   Depth gadget                           E-gad-Depth
  5032.   Depth gadget                           Con-gad-Depth
  5033.   DEPTH=                                 Par-TSMorph-render
  5034.   Distribution                           Distribution
  5035.   Down gadget                            E-gad-Down
  5036.   DX=                                    Par-TSMorph-render
  5037.   DY=                                    Par-TSMorph-render
  5038.   Edit gadgets                           E-gad
  5039.   Edit keyboard commands                 E-Key
  5040.   Edit menu                              CI-men-E
  5041.   Edit menu                              TSMP-men-Edit
  5042.   Edit menu                              TSMP-men-Settings
  5043.   Edit menus                             CI-men
  5044.   Edit Mode sub menu                     CI-men-E-EMode
  5045.   Edit Modes                             EModes
  5046.   Edit Points menu item                  I-men-P-Edit_Points
  5047.   Edit Points... gadget                  I-gad-Edit_Points
  5048.   Edit Windows                           Edit
  5049.   EGS=                                   Par-TSMorph
  5050.   EGS=                                   Par-TSMorph-render
  5051.   Error                                  Req-Error
  5052.   Error Messages                         Errors
  5053.   Errors                                 Bugs
  5054.   Exit Point menu item                   CI-men-P-Exit_Points
  5055.   File Format                            File_Format
  5056.   File naming                            File_Names
  5057.   File One gadget                        I-gad-File_One
  5058.   File Two gadget                        I-gad-File_Two
  5059.   FILES=                                 Par-TSMorph
  5060.   FILES=                                 Par-TSMorph-render
  5061.   First gadget                           Con-gad-First
  5062.   First menu item                        CI-men-E-Frame-First
  5063.   Format                                 File_Format
  5064.   Frame                                  Req-Progress
  5065.   Frame Number                           Req-FrameNumber
  5066.   Frame sub menu                         CI-men-E-Frame
  5067.   Frames gadget                          I-gad-Frames
  5068.   Get 24 File 1 gadget                   I-gad-Get_24_File_1
  5069.   Get 24 File 2 gadget                   I-gad-Get_24_File_2
  5070.   Get File One gadget                    I-gad-Get_File_One
  5071.   Get File Two gadget                    I-gad-Get_File_Two
  5072.   Get Name gadget                        I-gad-Get_Name
  5073.   GetValue                               AR-Prescript
  5074.   Goto gadget                            Con-gad-Goto
  5075.   Goto item                              CI-men-E-Frame-Goto
  5076.   Hardware                               Hard-Software
  5077.   Height gadget                          I-gad-Height
  5078.   Help Text gadget                       I-gad-Help
  5079.   HELP=                                  Par-TSMorph
  5080.   Hints                                  Hints
  5081.   History                                History
  5082.   Horizontal scroll bar                  E-gad-Horiz
  5083.   Info gadgets                           I-gad
  5084.   Info keyboard controls                 I-Key
  5085.   Info menus                             I-men
  5086.   Information Window                     Info
  5087.   Installation                           Installation
  5088.   INTEGER=                               Par-TSMorph-render
  5089.   Interface                              Interface
  5090.   KEEPSETTINGS=                          Par-TSMorph
  5091.   L1                                     EMode-Link
  5092.   L2                                     EMode-Link
  5093.   Last gadget                            Con-gad-Last
  5094.   Last item                              CI-men-E-Frame-Last
  5095.   Last Saved menu item                   TSMP-men-E-LastS
  5096.   Left gadget                            E-gad-Left
  5097.   Libraries                              Requirements
  5098.   Line                                   Req-Progress
  5099.   Link                                   EMode-Link
  5100.   List of files                          Installation
  5101.   Lnk                                    EMode-Link
  5102.   Loadscript                             AR-Loadscript
  5103.   LOADSCRIPT=                            Par-TSMorph-render
  5104.   MODE=                                  Par-TSMorph-render
  5105.   Modes                                  EModes
  5106.   Mouse Pointer                          EModes
  5107.   Mov                                    EMode-Move
  5108.   Move                                   EMode-Move
  5109.   Name gadget                            I-gad-Name
  5110.   New menu item                          I-men-P-New
  5111.   New Points menu item                   CI-men-P-New
  5112.   Next gadget                            Con-gad-Next
  5113.   Next item                              CI-men-E-Frame-Next
  5114.   None                                   EMode-Move
  5115.   OK gadget                              Req-Add_Grid-gad-OK
  5116.   One                                    EMode-One
  5117.   Open menu item                         TSMP-men-P-Open
  5118.   Open menu item                         I-men-P-Open
  5119.   Open Points menu item                  CI-men-P-Open
  5120.   OPENMODE=                              Par-TSMorph
  5121.   Overview                               Overview
  5122.   Parameter files                        File_Format
  5123.   Parameters                             Par
  5124.   Pointer                                EModes
  5125.   Postscript                             AR-Postscript
  5126.   POSTSCRIPT=                            Par-TSMorph-render
  5127.   Preferences editor                     TSMorph-prefs
  5128.   Prescript                              AR-Prescript
  5129.   PRESCRIPT=                             Par-TSMorph-render
  5130.   Preview menu item                      I-men-P-Preview
  5131.   Preview menu item                      CI-men-P-Preview
  5132.   PREVIEW=                               Par-TSMorph
  5133.   Previous gadget                        Con-gad-Previous
  5134.   Previous menu item                     CI-men-E-Frame-Previous
  5135.   Progress                               Req-Progress
  5136.   Project menu                           CI-men-P
  5137.   Project menu                           I-men-P
  5138.   Project menu                           TSMP-men-Project
  5139.   PUBSCREEN=                             Par-TSMorph
  5140.   PUBSCREENR=                            Par-TSMorph-render
  5141.   QUALITY=                               Par-TSMorph-render
  5142.   Quit menu item                         CI-men-P-Quit
  5143.   Quit menu item                         I-men-P-Quit
  5144.   Quit menu item                         TSMP-men-P-Quit
  5145.   Really quit?                           Req-Really_quit
  5146.   Rel                                    EMode-Relative
  5147.   Relative                               EMode-Relative
  5148.   REQTOOLS=                              Par-TSMorph
  5149.   REQTOOLS=                              Par-TSMorph-render
  5150.   Requesters                             Req
  5151.   Requirements                           Requirements
  5152.   Reset To Defaults menu item            TSMP-men-E-ResetD
  5153.   Restore menu item                      TSMP-men-E-Restore
  5154.   Right gadget                           E-gad-Right
  5155.   Save As menu item                      TSMP-men-P-SaveAs
  5156.   Save As... menu item                   CI-men-P-Save_As
  5157.   Save As... menu item                   I-men-P-Save_As
  5158.   Save gadget                            TSMP-Save
  5159.   Save menu item                         I-men-P-Save
  5160.   Save menu item                         CI-men-P-Save
  5161.   SAVEFORMAT=                            Par-TSMorph-render
  5162.   Settings menu                          men-Settings
  5163.   SETTINGS=                              Par-TSMorph
  5164.   SETTINGS=                              Par-TSMorph-render
  5165.   SETTINGS=                              Par
  5166.   Single gadget                          I-gad-Single
  5167.   Size gadget                            E-gad-Size
  5168.   Software                               Hard-Software
  5169.   Start gadget                           I-gad-Start
  5170.   Stop                                   Req-Progress
  5171.   StoreValue                             AR-Prescript
  5172.   Tips                                   Hints
  5173.   Tool types                             Par
  5174.   TOOLPRI=                               Par-TSMorph-render
  5175.   Triangulate menu item                  CI-men-E-Triangulate
  5176.   TSMorph                                Overview
  5177.   TSMorph-prefs                          TSMorph-prefs
  5178.   TSMorph-prefs Gadgets                  TSMP-gad
  5179.   TSMorph-prefs menus                    TSMP-men
  5180.   TSMorph-render                         Overview
  5181.   Tutorial                               Overview
  5182.   Two                                    EMode-Two
  5183.   U1                                     EMode-Unlink
  5184.   U2                                     EMode-Unlink
  5185.   Undo                                   EModes
  5186.   Unl                                    EMode-Unlink
  5187.   Unlink                                 EMode-Unlink
  5188.   Unsaved project                        Req-Unsaved
  5189.   Up gadget                              E-gad-Up
  5190.   Use gadget                             TSMP-Use
  5191.   Vertical scroll bar                    E-gad-Vert
  5192.   Width gadget                           I-gad-Width
  5193.   X Cells gadget                         Req-Add_Grid-gad-X_Cells
  5194.   Y Cells gadget                         Req-Add_Grid-gad-Y_Cells
  5195.   Zoom gadget                            I-gad-Zoom
  5196.   Zoom gadget                            TSMP-Zoom
  5197.   Zoom gadget                            E-gad-Zoom
  5198.   ZOOM=                                  Par-TSMorph
  5199.  
  5200.  
  5201.